Delete a Team | Vercel REST API

APIs & SDKs

Delete a Team

DELhttps://api.vercel.com/v1/teams/{teamId}

Delete a team under your account. You need to send a DELETE request with the desired team id. An optional array of reasons for deletion may also be sent.

https://api.vercel.com/v1/teams/{teamId}

const response = await fetch('https://api.vercel.com/v1/teams/teamId?newDefaultTeamId=string&slug=string', {
  method: 'DELETE',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json',
  },
});

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

Response

{
  "id": "team_LLHUOMOoDlqOp8wPE4kFo9pE",
  "newDefaultTeamIdError": "true"
}

Authentication

AuthorizationbearerToken

Default authentication mechanism

Path parameters

teamIdstringRequired

The Team identifier to perform the request on behalf of.

Query parameters

newDefaultTeamIdstringOptional

Id of the team to be set as the new default team

slugstringOptional

The Team slug to perform the request on behalf of.

Body

application/json

reasonsarrayOptional

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

Response

200The Team was successfully deleted

idstringRequired

The ID of the deleted Team

newDefaultTeamIdErrorbooleanOptional

Signifies whether the default team update has failed, when newDefaultTeamId is provided in request query.

Errors

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

401The request is not authorized.

402Error

403You do not have permission to access this resource. The authenticated user can't access the team

404Error

409Error

410Error

503Error

Cross-link map: Delete a Team (/docs/rest-api/teams/delete-a-team)

From the Vercel docs graph (built 2026-10-13T05:35:52.211Z), 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

Remove a Team Member — DELETE /v1/teams/{teamId}/members/{uid} — Remove a Team Member from the Team, or dismiss a user that requested access, o
Create a Team — POST /v1/teams — Create a new Team under your account. You need to send a POST request with the desired Team slug, and..
Delete a Team invite code — DELETE /v1/teams/{teamId}/invites/{inviteId} — Delete an active Team invite code.
Request access to a team — POST /v1/teams/{teamId}/request — Request access to a team as a member. An owner has to approve the request. Only 100 us
Delete a microfrontends group — DELETE /v1/teams/{teamId}/microfrontends/{groupId} — Deletes a microfrontends group from the team associated with the gr

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/teams/{teamId}

const response = await fetch('https://api.vercel.com/v1/teams/teamId?newDefaultTeamId=string&slug=string', {
  method: 'DELETE',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json',
  },
});

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

Response

{
  "id": "team_LLHUOMOoDlqOp8wPE4kFo9pE",
  "newDefaultTeamIdError": "true"
}

OpenAPI Specification