v1

latestOpenAPI 3.0.22026-07-144652931.4 MB
OAuth Delegations

Delete all OAuth delegations

Delete all OAuth delegations as per provided query parameters.

An OAuth delegation represents an instance of a user or account's authorization to an app (via OAuth) to access their PagerDuty account. Common apps include the PagerDuty mobile app, Slack, Microsoft Teams, and third-party apps. It also represents a user session in the PagerDuty web app.

Deleting an OAuth delegation will revoke that instance of an app's access to that user or account. To grant access again, reauthorization/reauthentication will be required.

This endpoint supports deleting mobile app OAuth delegations for a given user, which is equivalent to signing users out of the mobile app. It also supports deleting delegations of type web, which is equivalent to signing users out of the web app.

This is a synchronous API.

Scoped OAuth requires: oauth_delegations.write

delete/oauth_delegations

Query parameters

user_idstring required

The ID of the user for whom this request is applicable.

type'mobile' | 'web' required

The type of OAuth delegations this request should target. Allowed values are 'mobile' (to sign users out of the mobile app) and 'web' (to sign users out of the web app). You can pass one or more types in, separated by commas (e.g., type=web,mobile).

Headers

Acceptstring required

The Accept header is used as a versioning header.

Content-Type'application/json' required

Response

The request to delete delegations has been processed.

statusstring

Example response

{
  "status": "ok"
}