---
title: "Delete an organization"
method: DELETE
path: "/v1/{organization}/organization/"
tags: ["Organization"]
---

# Delete an organization

`DELETE /v1/{organization}/organization/`

Delete an organization. All of the organization's data are erased. Some analytical data will be asynchronously removed at
a future date.

Unlike other endpoints, this endpoint is not transactional. If any operation fails during the execution, the endpoint does not
revert the performed actions. The caller should re-call this endpoint until it succeeds.

Regardless of whether this endpoint succeeds or not, the first time this endpoint is called, the organization is considered
deleted. Even if the endpoint fails and the organization isn't completely wiped, it's considered in an invalid state and any
other operations on it may fail.

#### Permissions
This endpoint requires the following permissions:
* `Organization:DeleteOrganization` for the organization to delete.

## Path parameters

- `organization` string, required

## Headers

- `x-mongo-cluster-name` string, nullable — The Mongo cluster name to perform this request in. This is usually not needed unless the organization does not exist yet in the Amigo organization infra config database.
- `Sec-WebSocket-Protocol` string[]

## Response `204`

Succeeded.

## Other responses

- `400` — The current environment or organization does not support this endpoint.
- `401` — Invalid authorization credentials.
- `403` — Missing required permissions.
- `404` — Specified organization is not found.
- `409` — A related operation is in progress.
- `422` — Invalid request path parameter failed validation.
- `429` — The user has exceeded the rate limit of 5 requests per minute for this endpoint.
- `503` — The service is going through temporary maintenance.

---

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