---
title: "Request organization deletion"
method: POST
path: "/organizations/{organizationID}/deletion-request"
tags: ["Organizations"]
---

# Request organization deletion

`POST /organizations/{organizationID}/deletion-request`

Flags the organization for deletion. The request is rejected if the organization still has active projects.
The subscription is cancelled immediately and any outstanding invoices are collected automatically after a grace period that prevents missing delayed usage reports.
Deletion completes asynchronously once all invoices are issued and settled.

## Response `202`

Deletion requested — the organization will be removed once all outstanding invoices are settled

## Other responses

- `400` — Error returned when the request is malformed or contains invalid parameters
- `401` — Error returned when authentication or authorization fails
- `403` — Error returned when authentication or authorization fails
- `409` — Generic error response
- `5XX` — Unexpected Error

## Changes

- **2026-07-14** `fcbf82ebfc05` — 1 warning
  - deleted the `path` request parameter `organizationID`
- **2026-05-25** `09e83097cbe5` — 1 breaking
  - removed the success response with the status `200`
- **2026-05-19** `4a70cd9b8ed6` — 1 info
  - added the success response with the status `200`
- **2026-05-05** `775fa3331d67` — 2 info
  - the security scope `org:write` was added to the endpoint's security scheme `xata`
  - the security scope `org:delete` was removed from the endpoint's security scheme `xata`
- **2026-04-30** `2d3101021f6a` — 1 info
  - endpoint added

[Full history](https://skmtc.dev/xataio/apis/xata-api/changes/organizations/:organizationID/deletion-request/post.md)

---

[API](https://skmtc.dev/xataio/apis/xata-api.md) · [All operations](https://skmtc.dev/xataio/apis/xata-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/xataio/xata-api/revisions/16b3a31dfdf8/schema)