Get all User Permissions
GET
/api/v2/users/{user_id}/permissions
X-Organization-Id (int, optional): Scope the permission-set read toanother organization —
effective_permissions / permission_sets arecomputed against it. Without it, the org resolves to the APIM
subscription key's org, or else the caller's own org. 404 if the
header org does not exist.
X-Authorization-Consistency-Token (string, optional): Authorizationconsistency token for read-after-write consistency.
including in another org via
X-Organization-Id.the org the read is scoped to (403 otherwise).
permission-sets feature flag is enabled,
data also carrieseffective_permissions — the union of assistant (agent) scopes grantedby every permission set that reaches the user (assigned directly or
inherited via team membership; e.g.
edit: ["project", "team"] meansthe user can edit assistants in projects they access AND assistants
shared with admin access with their teams, while
all subsumes everyother scope) — and
permission_sets, the contributing sets with theirsource (
direct or team).Request
Path Params
Header Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --globoff 'https:///api/v2/users//permissions' \
--header 'Ocp-Apim-Subscription-Key: ' \
--header 'Authorization: Bearer 'Response Response Example
200 - Example 1
{
"success": true,
"message": "string",
"data": {
"user_permissions": [
{
"organization": {
"id": 0,
"org_name": "string",
"domain": "string"
},
"permission": "string"
}
],
"effective_permissions": {
"agents": {
"view": [
"all"
],
"edit": [
"all"
],
"delete": [
"all"
],
"publish": [
"all"
],
"create": true
}
},
"permission_sets": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"name": "string",
"source": "direct",
"team": {
"id": 0,
"name": "string"
},
"permissions": {
"property1": "string",
"property2": "string"
}
}
]
}
}