|docs
Start Trial

Delete a user

Remove an existing user.

Returns 400 if the user has assigned incidents unless your pricing plan has the offboarding feature and the account is configured appropriately.

Note that the incidents reassignment process is asynchronous and has no guarantee to complete before the api call return.

Learn more about offboarding feature.

Users are members of a PagerDuty account that have the ability to interact with Incidents and other data on the account.

For more information see the API Concepts Document

Scoped OAuth requires: users.write

Authorization<token>

The API Key with format Token token=<API_KEY>

In: header

Path Parameters

id*string

The ID of the resource.

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

application/json

application/json

application/json