DirectoryUserRole
A request or response body; the type column links to the schemas it refers to.
DirectoryUserRole
| Field | Type | Required | Description |
|---|---|---|---|
| department_id | string (uuid) | yes | — |
| department_slug | string | yes | — |
| department_name | string | yes | — |
| role_id | string (uuid) | yes | — |
| role_slug | string | yes | — |
| role_name | string | yes | — |
| role_description | string | null | yes | — |
| permissions | array of string | yes | — |
| granted_by | string | null | yes | `users.id` of whoever granted the role; null when unrecorded. |
| granted_at | string (date-time) | yes | — |
| expires_at | string (date-time) | null | yes | When the grant lapses; null for an open-ended one. |
jsonExample
{
"department_id": "1b671a64-40d5-491e-99b0-da01ff1f3341",
"department_slug": "string",
"department_name": "string",
"role_id": "1b671a64-40d5-491e-99b0-da01ff1f3341",
"role_slug": "string",
"role_name": "string",
"role_description": "string",
"permissions": [
"records:read",
"records:write"
],
"granted_by": "string",
"granted_at": "2026-01-01T00:00:00.000Z",
"expires_at": "2026-01-01T00:00:00.000Z"
}