authentication

Delete an authentication token

Changed on

Invalidate an authentication token, such that it will no longer be valid for future HTTP requests.

delete/v3/user/tokens/{tokenId}

Request

  • Base URL: https://api.vercel.com
  • URL: https://api.vercel.com/v3/user/tokens/{tokenId}
  • Auth: HTTP bearer

Path parameters

tokenIdstring required

The identifier of the token to invalidate. The special value "current" may be supplied, which invalidates the token that the HTTP request was authenticated with.

Example:5d9f2ebd38ddca62e5d51e9c1704c72530bdc8bfdd41e782a6687c48399e8391

Query parameters

reason'logout'

Identifies an explicit logout for the deletion event. Only applies when tokenId is current.

logoutSource'v0' | 'vercel'

The product the caller is logging out of. Only applies when reason is logout and tokenId is current.

Response

Authentication token successfully deleted.

tokenIdstring required

The unique identifier of the token that was deleted.

Example response

{
  "tokenId": "5d9f2ebd38ddca62e5d51e9c1704c72530bdc8bfdd41e782a6687c48399e8391"
}

Changes