v1
latestOpenAPI 3.1.02026-08-0413468163.9 KBv1-orgs
Delete Org
Delete an organization.
Requires 'org.delete' permission (typically owner only).
⚠️ SMART DELETION LOGIC:
- Cannot delete your last organization
- You must either:
- Join/create another organization first, THEN delete this one
- Delete your account (which will auto-delete this org)
This ensures users always have at least one organization. Manually deletes all related data: memberships, role grants, API keys, invites, etc.
WARNING: This is irreversible!
Returns: 204 No Content on success
Raises: 400: This is your last organization
delete/v1/orgs/{org_id}
Path parameters
org_idstring required
Response
Successful Response