Authorization & tokens
Revoke a token
Revoke an access token or refresh token belonging to the client.
/oauth/revoke- Authentication
- OAuth protocol client authentication
- Required scopes
- See authentication requirements
- Idempotency key
- Not required
How to use this endpoint
Unknown or already-revoked tokens return the same empty success response. Confidential clients use their registered authentication method; public MCP clients send client_id without a secret. This endpoint does not accept a resource parameter.
curl --request POST '<origin from OAuth metadata>/oauth/revoke' \
--user '<client_id>:<client_secret>' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'token=<access or refresh token>'Use the exact endpoint URL from your environment's metadata. Confidential client examples use client_secret_basic; public MCP clients use client_id without a secret.
Request fields
5 fieldstokenSee descriptionSee description
access or refresh token to revoke
token_type_hintSee descriptionSee description
access_token | refresh_token (optional)
client_idSee descriptionSee description
client identifier where required
client_assertion_typeSee descriptionSee description
JWT bearer assertion type for private_key_jwt
client_assertionSee descriptionSee description
short-lived signed assertion for private_key_jwt
Headers (2)
AuthorizationConditional / optional- Use HTTP Basic for client_secret_basic. For private_key_jwt, omit this header and send the registered assertion fields. Public MCP clients use client_id with no Basic header, client secret or assertion. The example builder defaults to a confidential client; remove --user when adapting it for a public client.
Content-TypeRequired- application/x-www-form-urlencoded
curl --request POST '<origin from OAuth metadata>/oauth/revoke' \
--user '<client_id>:<client_secret>' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'token=<access or refresh token>'Use the exact endpoint URL from your environment's metadata. Confidential client examples use client_secret_basic; public MCP clients use client_id without a secret.
Successful outcomes: ok.
{}revocation processed
Errors to handle
Use the returned status and code to decide what to correct or retry.
- 400
invalid_request - 401
invalid_client