v1

latestOpenAPI 3.1.02026-08-0413468163.9 KB
v1-orgs

Delete Org

Delete an organization.

Requires 'org.delete' permission (typically owner only).

⚠️ SMART DELETION LOGIC:

  • Cannot delete your last organization
  • You must either:
    1. Join/create another organization first, THEN delete this one
    2. 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