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.

As with all Twitter API methods, HTTPS is always required.

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

Resource URL

https://api.twitter.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 Response

POST /oauth2/invalidate_token HTTP/1.1
Authorization: Basic eHZ6MWV2R ... o4OERSZHlPZw==
User-Agent: My Twitter App v1.0.23
Host: api.twitter.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"}