POST oauth2/invalidate_token

Allows a registered application to revoke an issued OAuth 2 Bearer Token by presenting its client credentials. Once a Bearer Token has been invalidated, new creation attempts will yield a different Bearer Token and usage of the invalidated token will no longer be allowed.

Successful responses include a JSON-structure describing the revoked Bearer Token.

Resource URL¶

https://api.x.com/oauth2/invalidate_token

Resource Information¶

Response formats	JSON
Requires authentication?	Yes
Rate limited?	Yes

Parameters¶

Name	Required	Description	Default Value	Example
access_token	required	The value of the bearer token to revoke.

Example request¶

POST /oauth2/invalidate_token HTTP/1.1
Authorization: Basic eHZ6MWV2R ... o4OERSZHlPZw==
User-Agent: My Twitter App v1.0.23
Host: api.x.com
Accept: */*
Content-Length: 119
Content-Type: application/x-www-form-urlencoded

access_token=AAAA%2FAAA%3DAAAAAAAA

Example response:

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Content-Length: 127
...

{"access_token":"AAAA%2FAAA%3DAAAAAAAA"}