---
title: "Changes to Delete a Team"
method: DELETE
path: "/v1/teams/{teamId}"
---

# Changes to Delete a Team

`DELETE /v1/teams/{teamId}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 7 of 137 revisions.

- **2026-09-30** `099fbe1f521c`: 1 info
- **2026-09-02** `284e10c18f4d`: 1 info
- **2026-07-21** `2ae10ee9d21c`: 1 info
- **2026-01-22** `c12186034433`: 1 breaking, 2 warning
- **2025-10-09** `50caddad4ae7`: 1 info
- **2025-03-19** `37b482c58c92`: 5 info
- **2022-12-06** `8eb562567170`: 1 info

## Changes

- **2026-09-30** `099fbe1f521c`: 1 info
  - added the non-success response with the status `404`
- **2026-09-02** `284e10c18f4d`: 1 info
  - added the non-success response with the status `503`
- **2026-07-21** `2ae10ee9d21c`: 1 info
  - added the non-success response with the status `410`
- **2026-01-22** `c12186034433`: 1 breaking, 2 warning
  - request body became required
  - added the new `false` enum value to the `newDefaultTeamIdError` response property for the response status `200`
  - added the new `true` enum value to the `newDefaultTeamIdError` response property for the response status `200`
- **2025-10-09** `50caddad4ae7`: 1 info
  - removed the non-success response with the status `404`
- **2025-03-19** `37b482c58c92`: 5 info
  - added the new optional `query` request parameter `newDefaultTeamId`
  - added the new optional `query` request parameter `slug`
  - added the non-success response with the status `401`
  - added the non-success response with the status `409`
  - added the optional property `newDefaultTeamIdError` to the response with the `200` status
- **2022-12-06** `8eb562567170`: 1 info
  - added optional request body

---

[Operation](https://skmtc.dev/vercel/apis/api/docs/v1/teams/:teamId/delete.md) - [API](https://skmtc.dev/vercel/apis/api.md) - [Page](https://skmtc.dev/vercel/apis/api/changes/v1/teams/:teamId/delete)