Delete User Account | Vercel REST API

APIs & SDKs

Delete User Account

DELhttps://api.vercel.com/v1/user

Initiates the deletion process for the currently authenticated User, by sending a deletion confirmation email. The email contains a link that the user needs to visit in order to proceed with the deletion process.

https://api.vercel.com/v1/user

const response = await fetch('https://api.vercel.com/v1/user', {
  method: 'DELETE',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json',
  },
});

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

Response

{
  "email": "user@example.com",
  "id": "icfg_1234567890",
  "message": "Verification email sent"
}

Authentication

AuthorizationbearerToken

Default authentication mechanism

Body

application/json

reasonsarrayOptional

Optional array of objects that describe the reason why the User account is being deleted.

Response

202Response indicating that the User deletion process has been initiated, and a confirmation email has been sent.

emailstringRequired

Email address of the User who has initiated deletion.

idstringRequired

Unique identifier of the User who has initiated deletion.

messagestringRequired

User deletion progress status.

Errors

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

402Error

403You do not have permission to access this resource.

410Error

Cross-link map: Delete User Account (/docs/rest-api/user/delete-user-account)

From the Vercel docs graph (built 2026-10-08T05:38:39.548Z), 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

Delete a Team — DELETE /v1/teams/{teamId} — Delete a team under your account. You need to send a \DELETE\\ request with the desired tea
Delete an authentication token — DELETE /v3/user/tokens/{tokenId} — Invalidate an authentication token, such that it will no longer be valid for future H
Get the User — GET /v2/user — Retrieves information related to the currently authenticated User.
Delete virtual model config — DELETE /ai-gateway/virtual-model-configs — Delete a virtual model config \(soft delete\)
Deletes a webhook — DELETE /v1/webhooks/{id} — Deletes a webhook

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 (1)

By site: vercel-docs (1)

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

https://api.vercel.com/v1/user

const response = await fetch('https://api.vercel.com/v1/user', {
  method: 'DELETE',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json',
  },
});

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

Response

{
  "email": "user@example.com",
  "id": "icfg_1234567890",
  "message": "Verification email sent"
}

OpenAPI Specification