Skip to main content
DELETE /api/v1/organizations/{id} Requires org.delete permission. The caller must be a member of the target organization and belong to at least one other organization — deleting your last organization is not allowed.
This is a soft delete. Organization data is retained in storage but becomes inaccessible to all members.

Path parameters

id
string
required
UUID of the organization to delete.

Response

deleted
boolean
required
Always true on success.

Errors

StatusWhen
400Invalid request or path parameter
401Missing or invalid Bearer token
403Caller lacks org.delete permission or is not a member of the target organization
404Organization not found
409This is the caller’s only organization; at least one other must exist before deleting

Example

curl -X DELETE http://localhost:8080/api/v1/organizations/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "Authorization: Bearer <token>"
{
  "deleted": true
}

Build docs developers (and LLMs) love