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

# Delete an organization

`DELETE /v1/organizations/{organization_id}/`

## Request

- Base URL: `https://api.ethiack.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ethiack.com/v1/organizations/{organization_id}/`
- Auth: none declared

Delete an organization on behalf of the integrator that manages it.

Restricted to integrators, as in legacy. The organization must belong
to the caller's own partner and must have granted that partner full
access (legacy's ``accept_impersonation``): another partner's or an
unknown organization is a 404, one that withheld consent a 403.
Its subscriptions are removed with it; its findings are kept, detached
from the organization, as legacy left them.

Args:
    organization_id (int): Identifier of the organization to delete.
    db (AsyncSession): Request-scoped database session.
    context (ActiveContext): Resolved caller identity and scope.
    partner_id (int): The caller's own integrator partner id.

Returns:
    SuccessResponse: The legacy delete envelope carrying the id.

## Path parameters

- `organization_id` integer, required

## Response `200`

Successful Response

- SuccessResponse: Standard response for successful write operations. Matches the ``SuccessResponse`` contract from api-3. Attributes: code (int): HTTP status code. description (str): Human-readable result description. id (int | str | None): Created/affected resource ID. success (bool): Always ``True`` for successful responses.
  - `code` integer, required
  - `description` string, required
  - `id` union
    - integer
    - string
  - `success` boolean

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/ethiack/apis/ethiack-api.md) - [All operations](https://skmtc.dev/ethiack/apis/ethiack-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ethiack/apis/ethiack-api/revisions/4eaba89bfebf?raw)
