Organization
The Organization settings page (/settings/organization) lets you update your organization’s display name and URL slug, and — for owners — permanently delete the organization.
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 owner or admin role. Members and viewers can view the page but the Save button is not available to them.
Roles and permissions
Section titled “Roles and permissions”| Action | Owner | Admin | Member | Viewer |
|---|---|---|---|---|
| View organization details | ✓ | ✓ | ✓ | ✓ |
| Edit name and slug | ✓ | ✓ | — | — |
| Delete organization | ✓ | — | — | — |
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.
Deletion logs all members out immediately and revokes all access. 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 | Owner or admin | Update organization name and/or slug. |
DELETE | /api/orgs/:orgId | Owner only | Permanently delete the organization and all associated data. |