---
title: "Close the organization and request erasure"
method: POST
path: "/v1/organization/close"
---

# Close the organization and request erasure

`POST /v1/organization/close`

## Request

- Base URL: `https://docs.greatwait.dev` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.greatwait.dev/v1/organization/close`
- Auth: HTTP bearer

Stops customer access, execution and new purchases across the organization. Ordinary closure can be reversed for seven days; immediate erasure skips that window. Non-financial erasure completes within thirty days unless suspended by an operator legal hold. Financial records remain under the configured retention policy. An interrupted request resumes under the same generation; closure is acknowledged only after every configured scheduling shard is fenced.

## Request body

- object
  - `expectedGeneration` integer, required
  - `immediate` boolean, required
  - `confirmation` 'delete organization', required

## Response `200`

Close the organization and request erasure

- object
  - `organizationId` string, required
  - `generation` integer, required
  - `phase` 'active' | 'closing' | 'closed' | 'restoring' | 'purging' | 'erased', required
  - `requestedAt` string, nullable, required
  - `reversibleUntil` string, nullable, required
  - `purgeDeadline` string, nullable, required
  - `immediate` boolean, required
  - `converged` boolean, required

## Other responses

- `400`: Problem document. Possible codes at this status: invalid_request.
- `401`: Problem document. Possible codes at this status: authentication_required, credential_expired, credential_revoked.
- `403`: Problem document. Possible codes at this status: scope_missing.
- `404`: Problem document. Possible codes at this status: not_found.
- `409`: Problem document. Possible codes at this status: state_conflict, version_conflict.
- `429`: Problem document. Possible codes at this status: rate_limited.
- `503`: Problem document. Possible codes at this status: capability_not_configured, service_unavailable.

---

[API](https://skmtc.dev/greatwait/apis/greatwait-v1.md) · [All operations](https://skmtc.dev/greatwait/apis/greatwait-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/greatwait/apis/greatwait-v1/revisions/6855bce23e72?raw)