Skip to main content
POST
Revoke an MCP client connection
The organization bot token must have the following scopes:
  • mcp-client-connection:write-high-impact
Revokes active tokens for one member and client in a workspace. Use the list MCP client connections endpoint to obtain the client_key. The operation returns the number of tokens revoked. If the member, workspace, or connection is not available to the organization token, the endpoint returns the same not-found response.
For an enterprise-managed connection, token revocation is temporary because the client can authenticate again. To block future connections, use deny or restore enterprise-managed access with access set to denied. The deny applies to that member’s enterprise-managed access for the workspace, not only to the connection identified by client_key.

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

Body

application/json
client_key
string
required

Stable client key returned by the list endpoint.

user_id
string<uuid>
required
workspace_id
string<uuid>
required

Response

revoked_token_count
number
required

Number of active tokens revoked.