Comprehensive member update (role, organization, team)

PUT

/api/organizations/{org_id}/members/{target_user_id}

Perform a combined update of a member's role, organization, and/or team
assignment in a single request.

Permission rules:

Administrators / super_admin: can update role, transfer to another
organization, and change team assignment.

Team managers: can only update team assignment for members in their
own teams.

Transfer restrictions:

Cannot change another administrator's role.

To transfer a member to another organization, the caller must also be
an administrator (or super_admin) of the destination organization.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

API Key

Add parameter in header

X-API-Key

Example:

X-API-Key: ********************

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Member updated.

Body

🟠403

🟠404

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://my.xentree.com/api/organizations//members/' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "role": "string",
    "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
    "team_id": "810007d0-bec5-486c-b5d1-28fcd8a079ba"
}'

Response Example

{
    "user_id": "string",
    "username": "string",
    "email": "string",
    "full_name": "string",
    "role": "string",
    "joined_at": "string",
    "team_id": "810007d0-bec5-486c-b5d1-28fcd8a079ba",
    "team_name": "string"
}

Modified at 2026-04-23 07:01:35

Update a member's role

Remove a member from an organization