Delete Organization
| Description | Deletes an existing sub-org related to a given root org id |
| HTTP Method | /v1/identity/organizations/{organization_id}/orgunits/{orgunit_id} |
| HTTP Path | DELETE |
| Associated Scope(s) | identity.organizations |
Request Path Parameters (If Any)
| Name | Type | Description |
|---|---|---|
| organization_id | string | Root Org UUID. |
| orgunit_id | string | ID of sub-org to be deleted |
Response Fields (If Any)
In response to a successful DELETE, the server will return a successful HTTP status code 204 (No Content).
Endpoint Specific Errors (Standard API Errors are defined here)
| Http Status Code | Code | Message |
|---|---|---|
| 400 | bad_request | A bad request like “non-existent orgID” |
| 401 | unauthorized | No authentication provided, or invalid auth credentials, or missing scopes, etc. |
| 412 | precondition_failed | Examples “existing children orgs found”, “existing employees found” etc |