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

Authorization

api_key

Authorization<token>

The API Key with format Token token=<API_KEY>

In: header

Path Parameters

id*string

The ID of the resource.

delegation_id*string

The ID of the delegation.

Header Parameters

Accept*string

The Accept header is used as a versioning header.

Default"application/vnd.pagerduty+json;version=2"

Content-Type*"application/json"

Default"application/json"

Value in

"application/json"

Response Body

`application/json`

curl -X GET "https://example.com/users/{id}/oauth_delegations/{delegation_id}" \  -H "Accept: application/vnd.pagerduty+json;version=2" \  -H "Content-Type: application/json"

{  "oauth_delegation": {    "client_id": "PagerDutyLogin",    "created_at": "2026-01-01T12:00:00Z",    "expires_at": "2026-01-08T12:00:00Z",    "id": "e53326c6-a713-409c-8f7e-ps1xczid",    "scope": "openid profile",    "self": "https://api.pagerduty.com/users/PXPGF42/oauth_delegations/e53326c6-a713-409c-8f7e-ps1xczid",    "status": "issued",    "type": "web"  }}

Get a user's delegation

Authorization

Path Parameters

Header Parameters

Response Body

200application/json

400application/json

401application/json

403application/json

404application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`