Update a Permission on a Team

PUT

/api/v2/teams/{team_id}/permissions

Changes the role a user holds on a team, for example to make a member an admin. The user must
already hold a role; give a first role with POST instead.

The user gets the new role before losing the old one: if the call returns 503, the user may
hold both roles, which reads as admin; to finish a change to member, repeat the call.

Requires manage on the team: being one of its admins, or an organization admin.

Request

Path Params

Header Params

Body Params

application/json

Required

Examples

Responses

🟢200

application/json

The role was changed, or already matched (message Permission already set to the requested value, and nothing changed).

Headers

Bodyapplication/json

🟠400

🟠401

🟠403

🟠404

🔴500

🔴503

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff --request PUT 'https:///api/v2/teams//permissions' \
--header 'X-Authorization-Consistency-Token;' \
--header 'Organization-Id;' \
--header 'Ocp-Apim-Subscription-Key: ' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data '{
    "subject_type": "user",
    "subject_id": "456",
    "relation": "admin"
}'

Response Example

200 - Member made an admin

{
    "success": true,
    "message": "Permission updated successfully",
    "data": {
        "team_id": 9,
        "subject_type": "user",
        "subject_id": "21",
        "subject_name": "Sam Ortiz",
        "old_relation": "member",
        "new_relation": "admin",
        "updated_at": "2026-10-28T14:07:40.019311+00:00"
    }
}

Grant Permission on a Team

Revoke Permission on a Team