Get User Permissions on a Specific Team

GET

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

Shows the role one user holds on one team, worked out from what the user can do on it, so an
organization admin reads as admin even outside the team. Use it to check a user's standing in
a team before you change their role.

You can always read your own role. Reading another user's role requires manage on the team:
being one of its admins, or an organization admin.

Request

Path Params

Header Params

Responses

🟢200

application/json

The user's role on the team.

Bodyapplication/json

🟠400

🟠401

🟠403

🟠404

🔴500

🔴503

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff 'https:///api/v2/teams//users//permissions' \
--header 'X-Authorization-Consistency-Token;' \
--header 'Organization-Id;' \
--header 'Ocp-Apim-Subscription-Key: ' \
--header 'Authorization: Bearer '

Response Example

200 - Member of the team

{
    "success": true,
    "message": "User permissions on team retrieved successfully",
    "data": {
        "user_id": 21,
        "user_name": "Sam Ortiz",
        "email": "[email protected]",
        "team_id": 9,
        "team_name": "Support Leads",
        "relations": [
            "member"
        ]
    }
}

Revoke Multiple Permissions on a Team

Get User Permissions on Multiple Teams