Clerk API (unofficial showcase)
POST/oauth_applications/{oauth_application_id}/revoke_token

Revoke an OAuth application token

Revoke both OAuth access token and refresh token for the associated grant for the given OAuth application. The request may specify either token. JWT access tokens cannot be revoked.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

1 parameter · 1 body field
oauth_application_idstringrequired
The ID of the OAuth application for which to revoke the token
tokenstringrequired
The opaque OAuth access token or refresh token to revoke. All tokens associated with the same OAuth grant are also revoked.

5 status codes
204Token revoked
400Request was not successful
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional
403Authorization invalid
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional
404Resource not found
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional
422Invalid request parameters
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional

Error handling

A 400 is returned: Request was not successful. A 403 is returned: Authorization invalid. A 404 is returned: Resource not found. A 422 is returned: Invalid request parameters.