teams

Delete a Team

Changed on

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. Enterprise teams can only be deleted in test billing mode and when not linked to an organization.

delete/v1/teams/{teamId}

Request

  • Base URL: https://api.vercel.com
  • URL: https://api.vercel.com/v1/teams/{teamId}
  • Auth: HTTP bearer

Path parameters

teamIdstring required
Example:team_1a2b3c4d5e6f7g8h9i0j1k2l

The Team identifier to perform the request on behalf of.

Query parameters

newDefaultTeamIdstring

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

Example:team_LLHUOMOoDlqOp8wPE4kFo9pE
slugstring
Example:my-team-url-slug

The Team slug to perform the request on behalf of.

Request body

Response

The Team was successfully deleted

idstring required

The ID of the deleted Team

newDefaultTeamIdErrorfalse | true

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

Example response

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

Changes