AssignDirectoryUserRoleRequest

A request or response body; the type column links to the schemas it refers to.

Field	Type	Required	Description
department_id	string	yes	Department UUID id or slug, resolved within the organization. at least 1 character
role_id	string	yes	Role UUID id or slug, resolved within the department. at least 1 character
expires_at	string (date-time)	no	When the grant lapses; omit for an open-ended one. Must be in the future.

Field

Type

Required

Description

department_id

string

yes

Department UUID id or slug, resolved within the organization.

at least 1 character

role_id

string

yes

Role UUID id or slug, resolved within the department.

at least 1 character

expires_at

string (date-time)

When the grant lapses; omit for an open-ended one. Must be in the future.

jsonExample

{
  "department_id": "quality-assurance",
  "role_id": "reviewer",
  "expires_at": "2026-01-01T00:00:00.000Z"
}