---
title: "Schedule the org's deletion (owner only; name-confirmed). The org is suspended and every project stopped now; at destroy_after (the grace, 7 days) the projects and their data, the members and API keys are removed and billing ends with a final invoice. Until then an owner can cancel it (POST /v1/orgs/{org_id}/cancel-deletion). Refused with 402 while the org owes money."
method: DELETE
path: "/v1/orgs/{org_id}"
tags: ["orgs"]
---

# Schedule the org's deletion (owner only; name-confirmed). The org is suspended and every project stopped now; at destroy_after (the grace, 7 days) the projects and their data, the members and API keys are removed and billing ends with a final invoice. Until then an owner can cancel it (POST /v1/orgs/{org_id}/cancel-deletion). Refused with 402 while the org owes money.

`DELETE /v1/orgs/{org_id}`

## Request

- Base URL: `https://api.wavehouse.cloud`
- URL: `https://api.wavehouse.cloud/v1/orgs/{org_id}`
- Auth: one of:
  - API key in cookie `whc_session`
  - HTTP bearer
  - API key in header `X-API-Key`

## Path parameters

- `org_id` string, required

## Cookies

- `whc_last_org` string

## Request body

- DeleteOrgInput
  - `confirm_name` string, required: type the org's exact name to confirm deletion

## Response `202`

Accepted

- DeleteOrgOutput
  - `destroy_after` string, date-time, required: when the deletion becomes permanent; cancel before then with POST /v1/orgs/{org_id}/cancel-deletion
  - `status` 'deleting', required

## Other responses

- `429`: Rate limited, per client IP, API key or org; a client IP is also refused on every route for a while after repeated authentication failures. A limited operation carries RateLimit-Policy and RateLimit on every response; wait Retry-After seconds before retrying.
- `default`: Error

---

[API](https://skmtc.dev/wavehouse/apis/wavehouse-cloud-api.md) · [All operations](https://skmtc.dev/wavehouse/apis/wavehouse-cloud-api/llms.txt) · [OpenAPI document](https://skmtc.dev/wavehouse/apis/wavehouse-cloud-api/revisions/adea029bf505?raw)