E-File Magic

Authorization & tokens

Revoke a token

Revoke an access token or refresh token belonging to the client.

POST
/oauth/revoke
Authentication
OAuth protocol client authentication
Required scopes
See authentication requirements
Idempotency key
Not required

Request fields

5 fields
tokenSee 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
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.