Get a team's permission sets and effective permissions

Returns every permission set assigned to the team, plus the union of the
scopes they grant together.

effective_permissions describes what a member can do BY VIRTUE OF THIS
TEAM. It is not the same as any individual member's effective permissions —
a member may hold more through direct assignments or another team. For a
person's full picture use GET /api/v2/users/{user_id}/permissions.

Path Parameters:

team_id (int): ID of the team to read.

Request Headers:

X-Authorization-Consistency-Token (string, optional): Authorization
consistency token for read-after-write consistency.

Authorization:

Requires org manage (admin) on the organization the read is scoped to.

Returns:

200 OK: team_id, team_name, organization_id, permission_sets and —
when the permission-sets feature flag is enabled — effective_permissions.
Entity blocks appear only for entities whose grants are currently enforced,
so nothing is reported that authorization is not yet applying.

400 Bad Request: If versioning fails.

403 Forbidden: If the caller lacks org admin access.

404 Not Found: If the team does not exist.

500 Internal Server Error: On unhandled exceptions.

503 Service Unavailable: If the authorization service is unavailable.

Current Version:

2.0.0

{ "success": true, "message": "string", "data": { "team_id": 0, "team_name": "string", "organization_id": 0, "effective_permissions": { "agents": { "view": [ "all" ], "edit": [ "all" ], "delete": [ "all" ], "publish": [ "all" ], "create": true }, "corpora": { "view": [ "all" ], "edit": [ "all" ], "delete": [ "all" ], "create": true }, "workflows": { "view": [ "all" ], "edit": [ "all" ], "delete": [ "all" ], "create": true } }, "permission_sets": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string", "source": "direct", "team": { "id": 0, "name": "string" }, "permissions": { "agents": { "view": "all", "edit": "all", "delete": "all", "publish": "all", "create": true }, "corpora": { "view": "all", "edit": "all", "delete": "all", "create": true }, "workflows": { "view": "all", "edit": "all", "delete": "all", "create": true } } } ] } }

Get a team's permission sets and effective permissions

Request

Responses