Delete an authentication token

APIs & SDKs

DELhttps://api.vercel.com/v3/user/tokens/{tokenId}

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

https://api.vercel.com/v3/user/tokens/{tokenId}

const response = await fetch('https://api.vercel.com/v3/user/tokens/tokenId?reason=string&logoutSource=string', {
  method: 'DELETE',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json',
  },
});

const data = await response.json();
console.log(data);

Response

{
  "tokenId": "5d9f2ebd38ddca62e5d51e9c1704c72530bdc8bfdd41e782a6687c48399e8391"
}

Authentication

AuthorizationbearerToken

Default authentication mechanism

Path parameters

tokenIdstringRequired

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.

Query parameters

reasonstringOptional

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

logoutSourcestringOptional

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

Response

200Authentication token successfully deleted.

tokenIdstringRequired

The unique identifier of the token that was deleted.

Errors

400One of the provided values in the request query is invalid.

403You do not have permission to access this resource.

404Token not found with the requested `tokenId`.

410Error

Cross-link map: Delete an authentication token (/docs/rest-api/authentication/delete-an-authentication-token)

From the Vercel docs graph (built 2026-10-09T15:41:22.984Z), spanning vercel.com docs + KB, nextjs.org, ai-sdk.dev, and other Vercel documentation sites. Full graph as JSON: https://vercel.com/docs/graph.json

Semantically closest pages

Create an Auth Token — POST /v3/user/tokens — Creates and returns a new authentication token for the currently authenticated User. The \`bearer
Get Auth Token Metadata — GET /v5/user/tokens/{tokenId} — Retrieve metadata about an authentication token belonging to the currently authenticated
List Auth Tokens — GET /v6/user/tokens — Retrieve a list of the current User's authentication tokens.
Authentication — Endpoints in the authentication group of the Vercel REST API Reference.
Delete User Account — DELETE /v1/user — Initiates the deletion process for the currently authenticated User, by sending a deletion confirmatio

This page links to (1)

Vercel REST API Reference — Interact programmatically with your Vercel account using the SDK or direct HTTP requests.

Pages that link here (2)

By site: vercel-docs (2)

Vercel REST API Reference — Interact programmatically with your Vercel account using the SDK or direct HTTP requests.
Authentication — Endpoints in the authentication group of the Vercel REST API Reference.

https://api.vercel.com/v3/user/tokens/{tokenId}

const response = await fetch('https://api.vercel.com/v3/user/tokens/tokenId?reason=string&logoutSource=string', {
  method: 'DELETE',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json',
  },
});

const data = await response.json();
console.log(data);

Response

{
  "tokenId": "5d9f2ebd38ddca62e5d51e9c1704c72530bdc8bfdd41e782a6687c48399e8391"
}

OpenAPI Specification