Introspect an OAuth token

Returns OAuth token metadata such as active state, type, and associated workspace.

Manage pages, blocks, data sources/databases, comments, file uploads, views, users, and search through the official versioned Notion API, with OAuth and async tasks. The complete boundary is the 49 endpoints in the official OpenAPI snapshot; workspace data is private user content, so Pontx does not proxy, cache, or aggregate it and callers use the local SDK/CLI directly.

Request

operationId: introspectToken
Server: https://api.notion.com
Authentication: bearerAuth, basicAuth

Request parameters

`Notion-Version`

headerstringrequired

API version date for the request; the current latest version is 2026-03-11.

2026-03-11

Request body

objectrequired

Properties: token

Responses

`200`

objectapplication/json

Request succeeded.

Properties: activeiatrequest_idscope

`400`

error_oauth_400application/json

Request parameters are invalid.

`401`

error_oauth_401application/json

Unauthenticated or the token is invalid.

`403`

error_oauth_403application/json

Access to the resource is forbidden.

`500`

error_oauth_500application/json

Upstream internal error.

{
  "active": true,
  "iat": 1,
  "request_id": "0ab51e95-9373-4d42-97f8-1b5b0a5c0b52",
  "scope": "example content"
}