List all permissions on a team

GET

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

Retrieves a list of all users who have direct permissions on a specific team.
This endpoint provides a view of team access controls, showing which users have direct access to the team.

Path Parameters:

team_id (int): The ID of the team

Authorization:

Requires manage permission on the team

Returns:

A response containing:

direct_permissions: {users: [...], teams: []}

users: List of users with direct permissions (can be edited/revoked)

teams: Empty array (teams don't have teams as subjects)

indirect_permissions: {users: [], teams: []}

users: Empty array (teams endpoint only returns direct users)

teams: Empty array (teams don't have teams as subjects)

Each user includes: user_id, user_name, email, relations (roles)

Note:

Only direct permissions are returned for teams

Direct permissions can be granted/revoked via POST/DELETE endpoints

Organization administrators have inherited access but are not shown in this endpoint

Current Version:

2.0.0

Request

Path Params

Header Params

Responses

🟢200

application/json

Successfully retrieved team permissions

Body

🟠403

🟠404

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request GET 'https:///api/v2/teams//permissions' \
--header 'Ocp-Apim-Subscription-Key: ' \
--header 'Authorization: Bearer '

Response Example

200 - Example 1

{
    "success": true,
    "message": "string",
    "data": {
        "team_id": 0,
        "team_name": "string",
        "organization_id": 0,
        "direct_permissions": {
            "users": [
                {
                    "user_id": "string",
                    "user_name": "string",
                    "email": "[email protected]",
                    "relations": [
                        "string"
                    ]
                }
            ],
            "teams": [
                {
                    "team_id": "string",
                    "team_name": "string",
                    "relations": [
                        "string"
                    ]
                }
            ]
        },
        "indirect_permissions": {
            "users": [
                {
                    "user_id": "string",
                    "user_name": "string",
                    "email": "[email protected]",
                    "relations": [
                        "string"
                    ],
                    "inheritance_source": "string"
                }
            ],
            "teams": [
                {
                    "team_id": "string",
                    "team_name": "string",
                    "relations": [
                        "string"
                    ],
                    "inheritance_source": "string"
                }
            ]
        }
    }
}

Teams

Grant permission on a team