Skip to content

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.

FieldRequiredConstraints
Organization NameYes2–100 characters
SlugYes2–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.

ActionRequired grant
View organization detailsAny member
Edit name and slugTenant-administrator grant (org-update)
Delete organizationOrg-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.

The Delete organization action is visible only to owners. To proceed:

  1. Click Delete organization in the Danger Zone card.
  2. In the confirmation dialog, type the organization slug exactly as shown.
  3. 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.

MethodPathAccessDescription
GET/api/orgs/:orgIdAny memberFetch organization details (name, slug).
PUT/api/orgs/:orgIdTenant-administrator grant (org-update)Update organization name and/or slug.
DELETE/api/orgs/:orgIdOrg-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.