---
title: "Delete a team"
method: DELETE
path: "/v2/teams/{teamId}"
tags: ["Teams"]
---

# Delete a team

`DELETE /v2/teams/{teamId}`

## Path parameters

- `teamId` number, required

## Headers

- `Authorization` string, required

## Response `200`

- OrgTeamOutputResponseDto
  - `status` 'success' | 'error', required
  - `data` OrgTeamOutputDto, required
    - `id` number, required
    - `parentId` number
    - `name` string, required
    - `slug` string
    - `logoUrl` string
    - `calVideoLogo` string
    - `appLogo` string
    - `appIconLogo` string
    - `bio` string
    - `hideBranding` boolean
    - `isOrganization` boolean, required
    - `isPrivate` boolean
    - `hideBookATeamMember` boolean
    - `metadata` object
    - `theme` string
    - `brandColor` string
    - `darkBrandColor` string
    - `bannerUrl` string
    - `timeFormat` number
    - `timeZone` string
    - `weekStart` string

## Changes

- **2025-09-26** (v2) `daa3e48bc03a` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/calcom/apis/cal-diy-api-v2/changes/v2/teams/:teamId/delete.md)

---

[API](https://skmtc.dev/calcom/apis/cal-diy-api-v2.md) · [All operations](https://skmtc.dev/calcom/apis/cal-diy-api-v2/llms.txt) · [OpenAPI document](https://skmtc.dev/calcom/apis/cal-diy-api-v2/revisions/efb5b29409bf?raw)