Organization
The Organization settings page (/account/org) lets you update your organization’s display name and URL slug, and — for owners — permanently delete the organization. Open it from Account → Organization.
The old /settings/organization URL still redirects to /account/org, so existing bookmarks keep working.
Organization details
Section titled “Organization details”| Field | Required | Constraints |
|---|---|---|
| Organization Name | Yes | 2–100 characters |
| Slug | Yes | 2–50 characters; lowercase letters, numbers, and hyphens only; must match ^[a-z0-9][a-z0-9-]*[a-z0-9]$ |
The slug appears in URLs and cannot contain uppercase letters, spaces, or special characters other than hyphens. It must start and end with a letter or number.
Saving changes requires the tenant-administrator grant (capability org-update). The Save control appears to everyone, but the change is refused without that grant.
Grants and permissions
Section titled “Grants and permissions”| Action | Required grant |
|---|---|
| View organization details | Any member |
| Edit name and slug | Tenant-administrator grant (org-update) |
| Delete organization | Org-administrator grant (org-delete) |
The Owner role corresponds to the org-wide org-administrator grant, and Admin to the org-wide tenant-administrator grant. See Team & Roles.
Danger Zone
Section titled “Danger Zone”Delete organization
Section titled “Delete organization”The Delete organization action is visible only to owners. To proceed:
- Click Delete organization in the Danger Zone card.
- In the confirmation dialog, type the organization slug exactly as shown.
- Click Delete organization permanently.
If the organization has an active subscription, the delete is refused with a 409 (ACTIVE_SUBSCRIPTION) and nothing is deleted. Cancel the subscription in Billing first; a subscription scheduled to cancel at period end no longer blocks the delete.
Deletion immediately ends every member’s access to the organization in Colony Cloud. There is no recovery path after confirming.
API reference
Section titled “API reference”| Method | Path | Access | Description |
|---|---|---|---|
GET | /api/orgs/:orgId | Any member | Fetch organization details (name, slug). |
PUT | /api/orgs/:orgId | Tenant-administrator grant (org-update) | Update organization name and/or slug. |
DELETE | /api/orgs/:orgId | Org-administrator grant (org-delete) | Permanently delete the organization and its Cloud data. Refused with 409 ACTIVE_SUBSCRIPTION while a subscription is active. Does not delete Pipeline Store data, GitHub App installations or Workers. |