API Reference
Organizations
Manage organizations.
Delete an Organization
DELETE
/organizations/{id}Delete an organization
Permanently deletes the organization and all associated data (links, apps, members, etc.) via database cascade. Requires the `X-Confirmation-Name` header matching the organization name. The API key can only delete its own organization.
Parameters
| Name | Type | In | Description |
|---|---|---|---|
id* | string | path | |
X-Confirmation-Name* | string | header | Must match the organization name exactly. |
Responses
200Deleted organization
| Field | Type | Description |
|---|---|---|
id | string | |
name | string | |
slug | string | |
plan | "free" | "starter" | "growth" | "scale" | |
monthly_click_limit | integer | |
billing_period_start | string | |
default_fallback_url | string | null | |
created_at | string | |
updated_at | string |
400Invalid ID or missing confirmation header
| Field | Type | Description |
|---|---|---|
error* | object |
401Unauthorized
| Field | Type | Description |
|---|---|---|
error* | object |
403Forbidden or confirmation name mismatch
| Field | Type | Description |
|---|---|---|
error* | object |
404Not found
| Field | Type | Description |
|---|---|---|
error* | object |