---
title: "Delete a Team"
method: DELETE
path: "/v1/teams/{teamId}"
tags: ["teams"]
---

# Delete a Team

`DELETE /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.

## Path parameters

- `teamId` string, required

## Query parameters

- `newDefaultTeamId` string — Id of the team to be set as the new default team
- `slug` string

## Request body

- object
  - `reasons` object[] — Optional array of objects that describe the reason why the team is being deleted.
    - `slug` string, required — Idenitifier slug of the reason why the team is being deleted.
    - `description` string, required — Description of the reason why the team is being deleted.

## Response `200`

The Team was successfully deleted

- object — The Team was successfully deleted
  - `id` string, required — The ID of the deleted Team
  - `newDefaultTeamIdError` false | true — Signifies whether the default team update has failed, when newDefaultTeamId is provided in request query.

## Other responses

- `400` — One of the provided values in the request body is invalid. One of the provided values in the request query is invalid.
- `401` — The request is not authorized.
- `402`
- `403` — You do not have permission to access this resource. The authenticated user can't access the team
- `409`
- `410`

---

[API](https://skmtc.net/vercel/apis/api.md) · [All operations](https://skmtc.net/vercel/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vercel/api/versions/61d1ba3f6dac/schema)