Sign in

v1

latestOpenAPI 3.0.22026-07-144652931.4 MB
Users

List a user's delegations

Get a list of OAuth delegations for a specific user.

This endpoint replaces the deprecated /users/{id}/sessions endpoint.

Required OAuth Scope: For Scoped OAuth requests, this operation requires the oauth_delegations.read scope.

Scoped OAuth requires: oauth_delegations.read

get/users/{id}/oauth_delegations

Path parameters

idstring required

The ID of the resource.

Query parameters

delegation_type'mobile' | 'web' | 'integration'

The type of OAuth delegations to filter on. Allowed values are 'mobile', 'web', and 'integration'. You can pass one or more types in, separated by commas (e.g., type=web,mobile).

status'issued' | 'revoked'

The status of the delegations to return. Allowed values are 'issued' and 'revoked'. You can pass one or more statuses in, separated by commas (e.g., status=issued,revoked).

limitinteger

The minimum of the limit parameter used in the request or the maximum request size of the API.

cursorstring

Optional parameter used to request the "next" set of results from an API. The value provided here is most commonly obtained from the next_cursor field of the previous request. When no value is provided, the request starts at the beginning of the result set.

Headers

Acceptstring required

The Accept header is used as a versioning header.

Content-Type'application/json' required

Response

Delegations retrieved sucessfully

limitinteger required

Number of results per page

moreboolean required

Whether there are more results available

next_cursorstring

Cursor for retrieving the next page (only present when more is true)

Example response

{
  "oauth_delegations": [
    {
      "id": "e53326c6-a713-409c-8f7e-ps1xczid",
      "status": "issued",
      "client_id": "PagerDutyLogin",
      "delegation_type": "web",
      "scope": "openid",
      "created_at": "2025-10-30T15:45:02Z",
      "expires_at": "2025-12-29T15:45:02Z",
      "self": "https://api.pagerduty.com/users/PBGVC7B/oauth_delegations/e53326c6-a713-409c-8f7e-ps1xczid"
    }
  ],
  "limit": 25,
  "more": true,
  "next_cursor": "eyJsYXN0RXZhbHVhdGVkS2V5Ijp7ImlkIjoiNzg5MWRkNzktZWIwZi00ZjIzLWE4YzQtcGdmeG0wOSJ9fQ=="
}