---
title: "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."
method: DELETE
path: "/teams/{teamId}"
tags: ["Teams"]
---

# 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}`

## Path parameters

- `teamId` string, required

## Response `200`

OK

- TeamInfo
  - `id` string, nullable
  - `memberIds` string[], nullable
  - `name` string, nullable
  - `externalName` string, nullable
  - `description` string, nullable
  - `subscriptionId` string, nullable
  - `timezone` string, nullable
  - `imageLastModified` string, date-time, nullable
  - `imageWebLastModified` string, date-time, nullable
  - `options` 0 | 1

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

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