Update a permission on a team

PUT

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

Updates an existing permission (changes role) for a user on a team.
This allows you to change someone's role without having to revoke and re-grant access, such as promoting a member to admin or demoting an admin to member.

Path Parameters:

team_id (int): The ID of the team

Request Body:

subject_type (str, required): Type of subject ("user")

subject_id (str, required): Unique identifier of the user

relation (str, required): New role to assign ("admin" or "member")

Roles:

admin: Full control over the team

member: Can view and use the team

Authorization:

Requires manage permission on the team

The user must already have some permission on the team

Returns:

A response containing the updated permission details

Current Version:

2.0.0

Request

Path Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Successfully updated permission

Body

🟠400

🟠403

🟠404

🔴500

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

200 - Example 1

{
    "success": true,
    "message": "string",
    "data": {
        "team_id": 0,
        "subject_type": "string",
        "subject_id": "string",
        "subject_name": "string",
        "old_relation": "string",
        "new_relation": "string",
        "updated_at": "2019-08-24T14:15:22.123Z"
    }
}

Grant permission on a team

Revoke permission on a team