Skip to main content
POST
/
v1
/
oauth
/
revoke
Revoke a token
curl --request POST \
  --url https://api.notion.com/v1/oauth/revoke \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --header 'Notion-Version: <notion-version>' \
  --data '
{
  "token": "<string>"
}
'
{
  "object": "<unknown>",
  "message": "<string>",
  "code": "invalid_request",
  "status": "<unknown>",
  "additional_data": {}
}

Authorizations

​
Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Headers

​
Notion-Version
enum<string>
required

The API version to use for this request. The latest version is 2025-09-03.

Available options:
2025-09-03

Body

application/json
​
token
string
required

Response

​
object
any
required
​
message
string
required
​
code
enum<string>
required
Available options:
invalid_request,
invalid_grant,
unauthorized_client,
unsupported_grant_type,
invalid_scope
​
status
any
required
​
additional_data
object