Skip to content
Status

Revoke an access token or refresh token

POSThttps://merchant.shuttleglobal.com/revoke

POST
/revoke

Authenticate your client in one of two ways:

  1. In the request body, with the client_id and client_secret parameters, or
  2. With HTTP Basic authentication, using your client_id as the username and your client_secret as the password

Use one method per request, not both. If you put client_id or client_secret in the body, put both there.

Invalidates either an access token or refresh token. Use this endpoint when:

  • A user logs out
  • A token may have been compromised
  • You want to clean up unused tokens
Media typeapplication/x-www-form-urlencoded
object
token
required
string

The token to revoke (either an access_token or refresh_token)

token_type_hint
string · enum

Optional hint about the type of token being revoked

Allowed values: access_token refresh_token
client_id
string

Your client ID. Required unless you send it with HTTP Basic authentication.

client_secret
string

Your client secret. Required unless you send it with HTTP Basic authentication.

Token successfully revoked

Invalid token format

Invalid client credentials

Was this page helpful?