---
title: "Changes to Deletes a team from the subscription.\r\nIt is only possible to delete empty teams or teams where all members are also members of other teams.\r\nIf a user would be without a team after deleting this team, the operation will not be allowed.\r\nYou need to assign these users to a different team first or delete them, to successfully delete that team."
method: DELETE
path: "/teams/{teamId}"
---

# Changes to Deletes a team from the subscription.
It is only possible to delete empty teams or teams where all members are also members of other teams.
If a user would be without a team after deleting this team, the operation will not be allowed.
You need to assign these users to a different team first or delete them, to successfully delete that team.

`DELETE /teams/{teamId}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 4 revisions.

- **2026-10-13** `bf9d377a0764`: 3 info

## Changes

- **2026-10-13** `bf9d377a0764`: 3 info
  - added the optional property `shortDescription` to the response with the `200` status (media type: text/plain)
  - added the optional property `shortDescription` to the response with the `200` status (media type: application/json)
  - added the optional property `shortDescription` to the response with the `200` status (media type: text/json)

---

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