/oauth2/revoke

POST

/oauth2/revoke

curl --request POST \
  --url https://gymgym.club/api/auth/oauth2/revoke \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "client_id": "example", "client_secret": "example", "token": "example", "token_type_hint": "example" }'

Revoke an OAuth2 access or refresh token

Authorizations

• bearerAuth

Request Body^required

Media typeapplication/json

object

client_id

OAuth2 client ID

string

client_secret

OAuth2 client secret

string

token

required

The token to revoke (access or refresh token)

string

token_type_hint

Hint about the token type. Recognized values: access_token, refresh_token.

string

Example^generated

{
  "client_id": "example",
  "client_secret": "example",
  "token": "example",
  "token_type_hint": "example"
}

Responses

200

Token revoked successfully. The response body is empty.

Media typeapplication/json

Empty object on success

object

Example^generated

{}

400

Invalid request or error response

Media typeapplication/json

object

error

required

string

error_description

string

error_uri

string

Example^generated

{
  "error": "example",
  "error_description": "example",
  "error_uri": "example"
}

401

Unauthorized. Due to missing or invalid authentication.

Media typeapplication/json

object

message

required

string

Example^generated

{
  "message": "example"
}

403

Forbidden. You do not have permission to access this resource or to perform this action.

Media typeapplication/json

object

message

string

Example^generated

{
  "message": "example"
}

404

Not Found. The requested resource was not found.

Media typeapplication/json

object

message

string

Example^generated

{
  "message": "example"
}

429

Too Many Requests. You have exceeded the rate limit. Try again later.

Media typeapplication/json

object

message

string

Example^generated

{
  "message": "example"
}

500

Internal Server Error. This is a problem with the server that you cannot fix.

Media typeapplication/json

object

message

string

Example^generated

{
  "message": "example"
}