---
title: "Delete a team"
method: DELETE
path: "/api/v1/teams/{team}"
---

# Delete a team

`DELETE /api/v1/teams/{team}`

Permanently deletes the team identified by `team`. This action is
irreversible — all team memberships, settings, and associated data are
removed.

The caller must be the team owner or an org admin. When `app` is present,
the caller must also hold the corresponding app scope.

## Path parameters

- `team` string, required

## Response `204`

No content

## Other responses

- `401` — Unauthorized
- `403` — Forbidden - app scope required
- `404` — Team not found

---

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