Skip to content
Governance Platform

Add user to organization

POST
/api/v1/organizations/{organizationId}/members
 
curl --request POST \
  --url https://localhost:8080/api/v1/organizations/example/members \
  --header 'Authorization: <Authorization>' \
  --header 'Content-Type: application/json' \
  --data '{ "roles": [ "organization_owner", "project_owner" ], "userId": "example" }'

Add a user to an organization with the specified roles and best-effort sync the membership to the bound IDP organization

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
organizationId
required
string

Organization ID or UUID (bare or urn:uuid)

Request Body

Section titled “Request Body ”

Roles to assign

Media type application/json
object
roles
required

At least one known role

Array<string>
>= 1 items
Example 
[
  "organization_owner",
  "project_owner"
]
userId
required
string

Responses

Section titled “ Responses ”

201

Section titled “201 ”

User added successfully

Media type application/json

A user’s membership in a single organization, and the roles it grants

object
joinedAt
string format: date-time
organizationId
integer
roles
Array<string>
status
string
Example generated
{
  "joinedAt": "2026-04-15T12:00:00Z",
  "organizationId": 1,
  "roles": [
    "example"
  ],
  "status": "example"
}

400

Section titled “400 ”

Invalid request

Media type application/json

Error body returned across the auth endpoints; the message is human-readable and not a stable identifier

object
error
string
error_description
string
Example 
{
  "error": "Unauthorized",
  "error_description": "Invalid token"
}

401

Section titled “401 ”

Unauthorized

Media type application/json

Error body returned across the auth endpoints; the message is human-readable and not a stable identifier

object
error
string
error_description
string
Example 
{
  "error": "Unauthorized",
  "error_description": "Invalid token"
}

403

Section titled “403 ”

Forbidden - requires Organization Owner role

Media type application/json

Error body returned across the auth endpoints; the message is human-readable and not a stable identifier

object
error
string
error_description
string
Example 
{
  "error": "Unauthorized",
  "error_description": "Invalid token"
}

404

Section titled “404 ”

Organization not found

Media type application/json

Error body returned across the auth endpoints; the message is human-readable and not a stable identifier

object
error
string
error_description
string
Example 
{
  "error": "Unauthorized",
  "error_description": "Invalid token"
}

409

Section titled “409 ”

User is already a member of this organization

Media type application/json

Error body returned across the auth endpoints; the message is human-readable and not a stable identifier

object
error
string
error_description
string
Example 
{
  "error": "Unauthorized",
  "error_description": "Invalid token"
}

500

Section titled “500 ”

Internal server error

Media type application/json

Error body returned across the auth endpoints; the message is human-readable and not a stable identifier

object
error
string
error_description
string
Example 
{
  "error": "Unauthorized",
  "error_description": "Invalid token"
}