Skip to main content
GET
Get approval delegation

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

Response

id
string
required

Approval delegation ID.

Example:

"apd_9dKs02LmPq1a3Z"

status
enum<string>
required

Lifecycle status: scheduled before starts_at, active between starts_at and ends_at, expired after ends_at, revoked once revoked.

Available options:
scheduled,
active,
expired,
revoked
Example:

"active"

delegator_id
string
required

ID of the user whose approvals are delegated, typically the one out of office.

Example:

"usr_4sYw1nB8xKe0Qm"

delegate_id
string
required

ID of the user who approves on behalf of the delegator.

Example:

"usr_7GhT2pLq9ZcV3r"

starts_at
string<date-time>
required

UTC timestamp when the delegation starts.

Example:

"2026-12-21T00:00:00Z"

ends_at
string<date-time>
required

UTC timestamp when the delegation ends. Must be in the future.

Example:

"2027-01-04T00:00:00Z"

reason
string | null
required

Free-text reason, such as an out-of-office period.

Example:

"Christmas holidays"

created_at
string<date-time>
required

UTC timestamp when the delegation was created.

Example:

"2024-12-20T16:04:11Z"

revoked_at
string<date-time> | null
required

UTC timestamp when the delegation was revoked, or null.

Example:

"2024-12-20T16:04:11Z"