Delete organization

DELETE

/api/v1/organizations/{id}

curl --request DELETE \
  --url http://localhost:3000/api/v1/organizations/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
  --header 'X-API-Key: <X-API-Key>'

• Development
• Production

Deletes an organization. When force=true, performs cascading deletion of all users, devices, deployments, and applications. Multi-tenant users keep their account and lose membership in this org only; single-tenant users are hard-deleted. Requires Super Admin privileges.

Authorizations

• api-key
• bearer

Parameters

Path Parameters

id

required

string format: uuid

Organization UUID

Query Parameters

force

string

When set to true, performs cascading deletion across users, devices, deployments, and applications. Optional.

Header Parameters

x-organization-id

string format: uuid

UUID of the organization (tenant) the request acts in. It selects the tenant and grants nothing: the server checks membership or an open tenant switch. Not needed for global operations. A malformed value returns 400. API keys are fixed to their own organization; another organization returns 403. The x-organization-source header grants nothing.

Responses

200

Organization force-deleted with cascade summary

Media typeapplication/json

object

removedMemberships

required

Number of OrganizationUser memberships removed from this tenant

number

deletedUsers

required

Number of users hard-deleted because the deleted tenant was their only membership

number

switchedUsers

required

Number of users that kept their account because they belong to at least one other tenant

number

deletedDevices

required

Number of devices soft-deleted as part of the cascade

number

cancelledDeployments

required

Number of deployments soft-deleted (cancelled) as part of the cascade

number

deletedApplications

required

Number of application packages soft-deleted as part of the cascade

number

Example^generated

{
  "removedMemberships": 1,
  "deletedUsers": 1,
  "switchedUsers": 1,
  "deletedDevices": 1,
  "cancelledDeployments": 1,
  "deletedApplications": 1
}

204

Organization deleted successfully (no force)

401

Unauthorized

403

Forbidden - Super Admin required

404

Organization not found

409

Organization has active resources or is your own