v5

latestOpenAPI 3.1.02026-07-31151195455.5 KB

delegations

Get delegations

Returns a list of request reviewer delegations configured for your organization.

get/delegations

Query parameters

delegator_user_idstring uuid

The delegator user ID to filter delegations by the user delegating their access review requests.

delegate_user_idstring uuid

The delegate user ID to filter delegations by the user being delegated to.

cursorstring

A cursor to indicate where to start fetching results.

page_sizeinteger

The maximum number of results to return per page. The default is 200.

Response

A list of delegations for your organization.

nextstring nullable

The cursor with which to continue pagination if additional result pages exist.

previousstring nullable

The cursor used to obtain the current result page.

total_countinteger

The total number of items in the result set.

Example response

{
  "results": [
    {
      "id": "4aed3e8a-727b-4d72-8010-3b8710c50bec",
      "delegator_user_id": "123e4567-e89b-12d3-a456-426614174000",
      "delegate_user_id": "7c86c85d-0651-43e2-a748-d69d658418e8",
      "start_time": "2023-10-01T12:00:00Z",
      "end_time": "2023-10-01T12:00:00Z",
      "reason": "I need to be out of the office",
      "created_at": "2023-10-01T12:00:00Z",
      "updated_at": "2023-10-01T12:00:00Z"
    }
  ],
  "next": "cD0yMDIxLTAxLTA2KzAzJTNBMjQlM0E1My40MzQzMjYlMkIwMCUzQTAw",
  "previous": "cj1sZXdwd2VycWVtY29zZnNkc2NzUWxNMEUxTXk0ME16UXpNallsTWtJ",
  "total_count": 2
}