Skip to content
AveraAveraAvera Documentation

Create an internal member

POST
/api/v1/tenants/{tenantId}/participations/internal
curl --request POST \
  --url https://app.avera.io/api/v1/tenants/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/participations/internal \
  --header 'Content-Type: application/json' \
  --data '{ "email": "example", "displayName": "example", "roles": [ "example" ], "initialPassword": "example" }'

On a federated tenant this grants access ahead of someone’s first sign-in; on a local-auth tenant it also sets the password the administrator hands over. Tenant-admin gated.

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
tenantId
required
string format: uuid

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
email
required
string
displayName
required
string
roles
required
Array<string>
initialPassword
string | null

Example generated

{
  "email": "example",
  "displayName": "example",
  "roles": [
    "example"
  ],
  "initialPassword": "example"
}

Responses

Section titled “Responses”

200

Section titled “200”

OK

Media type*/*
object
id
required
string format: uuid
tenantId
required
string format: uuid
tenantName
string | null
tenantSlug
string | null
userId
required
string format: uuid
scope
required
string
Allowed values: INTERNAL EXTERNAL SUPPORT
roles
required
Array<string>
Allowed values: TENANT_OWNER TENANT_ADMIN USER_ADMIN MEMBER
publicDisplayName
required
string
status
required
string
Allowed values: PENDING_ACCEPTANCE ACTIVE SUSPENDED ENDED
startDate
required
string format: date-time
endDate
string | null format: date-time
acceptedAt
string | null format: date-time
invitationReason
string | null
agreementRef
string | null
createdAt
required
string format: date-time