v1

latestOpenAPI 3.0.02026-07-26866217.8 KB
OAuth

Delete/Revoke Tokens

This endpoint allows clients to revoke an access or refresh token. Deleting/revoking a token will disconnect the Host from your application.

post/oauth/revoke

Request body

client_idstring required

The unique identifier for the client application requesting the token revocation.

client_secretstring required

The secret key associated with the client application, used to authenticate the revocation request.

tokenstring required

The access or refresh token to be revoked. Once revoked, the token cannot be used for further authentication.

Response

Successfully revoked the specified token.

request_idstring required

Unique identifier for the request.

error_codeinteger required

Numeric error code representing the status of the response. A value of 200 indicates success. <br> See the Error Codes section for more information.

error_msgstring required

Message detailing the status of the response.

Example response

{
  "error_msg": "Done."
}