Skip to main content
POST
/
v2
/
orgs
/
{orgSlug}
/
members
Add Org Members
curl --request POST \
  --url https://api.studio.prisme.ai/v2/orgs/{orgSlug}/members \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "users": [
    {
      "userId": "<string>",
      "email": "<string>",
      "roleSlug": "<string>",
      "groups": [
        "<string>"
      ]
    }
  ]
}
'
[
  {
    "orgSlug": "<string>",
    "userId": "<string>",
    "id": "<string>",
    "roleSlug": "<string>",
    "invitedBy": "<string>",
    "invitedAt": "<string>",
    "inviteEmail": "<string>",
    "inviteToken": "<string>",
    "joinedAt": "<string>",
    "groups": [
      "<string>"
    ],
    "createdBy": "<string>",
    "updatedBy": "<string>",
    "createdAt": "<string>",
    "updatedAt": "<string>"
  }
]

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
orgSlug
string
required

Body

application/json
​
users
object[]
required

Members to add. Each entry carries its own role and groups.

​
skipExisting
boolean

When true, members already in the org are silently skipped instead of triggering a 409. Useful for idempotent bulk imports / round-tripping a CSV export. Returns only the actually created memberships.

Response

Members added

​
orgSlug
string
required
​
userId
string
required
​
status
enum<string>
required
Available options:
active,
invited,
suspended
​
id
string
​
roleSlug
string
​
invitedBy
string
​
invitedAt
string
​
inviteEmail
string
​
inviteToken
string
​
joinedAt
string
​
joinedVia
enum<string>
Available options:
direct,
invite-code,
invite-email,
auto-join,
join-rule
​
groups
string[]

Org group slugs the user belongs to. Only populated on listOrgMembers when includeGroups=true.

​
createdBy
string
​
updatedBy
string
​
createdAt
string
​
updatedAt
string