Get User Permissions on Multiple Teams

GET

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

Shows the role a user holds on each of several teams in the organization, worked out from what
the user can do on each one. Use it to show which of a set of teams a user belongs to or
manages.

The organization is the one the Organization-Id header names, otherwise your subscription
key's, otherwise your own. Teams the user can't access are left out of teams; IDs that match
no team in the organization, and teams that couldn't be checked, are listed in omitted_ids
instead.

You can always read your own roles. Reading another user's roles requires being a member of
the organization (view on it).

Request

Path Params

Query Params

Header Params

Responses

🟢200

application/json

The user's role on each team they can access.

Bodyapplication/json

🟠400

🟠401

🟠403

🟠404

🔴500

🔴503

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

200 - Roles on two teams

{
    "success": true,
    "message": "User permissions on teams retrieved successfully",
    "data": {
        "user_id": 15,
        "user_name": "Dana Lee",
        "email": "[email protected]",
        "teams": [
            {
                "team_id": 9,
                "team_name": "Support Leads",
                "relations": [
                    "admin"
                ]
            },
            {
                "team_id": 12,
                "team_name": "Billing",
                "relations": [
                    "member"
                ]
            }
        ],
        "omitted_ids": [
            77
        ]
    }
}

Get User Permissions on a Specific Team

Get all Teams