Skip to main content
API Explorer|API Explorer
Infrastructure/Tenants
DELETEInfrastructureSince 1.0SynchronousAuth Required

DeleteOrgUnit

Delete an organizational unit and optionally its children.

Execution Availability

Try It Out

Submit a mock request using the current auth context and example-driven inputs.

Path Parameters

Request Inputs

Path Parameters

  • tenantUuidStringRequired

    UUID of the tenant that owns the org unit

  • uuidStringRequired

    UUID of the organizational unit to delete

Responses

DELETE endpoints return an empty object on success, or a standard error structure on failure.

Success Response

{}

Error Response

{
  "error": {
    "code": "SYS.1001",
    "description": "A message or a operation timeout",
    "details": "Delete resource timeout after 300s"
  }
}

Endpoint

DELETE/api/v1/tenants/{tenantUuid}/org/departments/{uuid}

/api/v1/tenants/{tenantUuid}/org/departments/{uuid}

Operation ID

DeleteOrgUnit

Permalink

Request Example

curl -X DELETE '{host}/api/v1/tenants/{tenantUuid}/org/departments/{uuid}' -H 'Authorization: Bearer {token}'

Response Example

200
{}

Change History

This API has no change history records yet.

View all change history