---
title: "Delete a child organization by identifier"
method: DELETE
path: "/organizations/{id_organization}"
tags: ["orgnaizations"]
---

# Delete a child organization by identifier

`DELETE /organizations/{id_organization}`

## Request

- Base URL: `https://api.planvortex.com/v1.0.0`
- URL: `https://api.planvortex.com/v1.0.0/organizations/{id_organization}`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (client credentials, token URL `https://api.planvortex.com/v1.0.0/oauth/token`)

Delete child organization by its identifier

## Path parameters

- `id_organization` string, required

## Response `200`

Successful operation

- Success: What an operation with nothing to return answers. A failure never looks like this: it comes back as an `Error` with HTTP 400.
  - `success` boolean, required

## Other responses

- `400`: The request failed. The body carries the PlanVortex error code in `code`: | Code | Meaning | | --- | --- | | `1101` | Invalid organization | | `523` | Invalid application |
- `500`: Unhandled error by the server

---

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