Revoke a token

Revoke an access token.

POST /v1/oauth/revoke

TypeScript SDK

JavaScript

import { Client } from "@notionhq/client"

const notion = new Client()

const response = await notion.oauth.revoke({
  client_id: process.env.OAUTH_CLIENT_ID,
  client_secret: process.env.OAUTH_CLIENT_SECRET,
  token: "access_token_to_revoke"
})

200

{
  "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

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 2026-03-11.

Available options: 2026-03-11

Body

application/json

token · string · required

Response

200

application/json

request_id · string<uuid>