PIpinterest
oauth

Revoke a token

Changed on

Revokes an access or refresh token. Only tokens issued for system users are currently supported. Revoked tokens become immediately invalid and unusable.

post/oauth/token/revoke

Request

Request body application/x-www-form-urlencoded

tokenstring required

The token to revoke.

token_type_hint'access_token' | 'refresh_token'

The type of token to revoke.

Example request

{
  "token": "pinr.eyJhbGciOiJS..."
}

Response

The request has succeeded.

Changes

  • v5b698c180678aRevision changes
    • breaking

      added to the request property allOf list

    • breaking

      removed the enum value access_token of the request property

    • breaking

      removed the enum value refresh_token of the request property

    • info

      the request property type was generalized from string to no type

  • v543134ca41f18Revision changes
    • info

      endpoint added