Sign in

v1

latestOpenAPI 3.0.22026-07-144652931.4 MB
Users

Get a user's delegation

Get details about a specific OAuth delegation.

This endpoint replaces the deprecated /users/{id}/sessions/{session_id} 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/{delegation_id}

Path parameters

idstring required

The ID of the resource.

delegation_idstring required

The ID of the delegation.

Headers

Acceptstring required

The Accept header is used as a versioning header.

Content-Type'application/json' required

Response

Delegation retrieved successfully

idstring required

The unique identifier for the delegation

status'issued' | 'revoked' required

The current status of the delegation

client_idstring required

The OAuth client ID

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

The type of delegation

scopestring required

The OAuth scopes granted

created_atstring date-time required

When the delegation was created (ISO 8601 format)

expires_atstring date-time required

When the delegation expires (ISO 8601 format)

selfstring uri required

URL to retrieve this delegation in detail

Example response

{
  "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"
}