Skip to main content
DELETE
Revoke a personal access token in a workspace
The organization bot token must have the following scopes:
  • personal-access-token:write-high-impact
Use List personal access tokens to get the token’s id, then pass it as bot_id. After revocation, the token can no longer authenticate API requests or access Notion Workers. Repeating the request leaves the token revoked and returns an empty response. The workspace must belong to the organization that owns the organization bot token. The endpoint returns the same not-found response when the workspace or PAT does not exist, is outside the organization, or does not match the request.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Notion-Version
enum<string>
required

The Admin API version to use for this request.

Available options:
2026-06-01

Path Parameters

bot_id
string<uuid>
required
space_id
string<uuid>
required

Response

The response is of type object.