Organizations
Manage organizations, members, roles, and API keys.
Organizations are the top-level tenant in Ctrl AI. All units, workflows, domains, and audit logs are scoped to an organization.
List Organizations
GET /api/v1/orgsReturns organizations the authenticated user belongs to.
Create Organization
POST /api/v1/orgs| Field | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Organization name |
slug | string | Yes | URL-friendly identifier (unique) |
Update Organization
PATCH /api/v1/orgs/{slug}Requires admin role. Can update name, settings (including LLM configuration), and plan.
Members
List Members
GET /api/v1/orgs/{slug}/membersInvite Member
POST /api/v1/orgs/{slug}/members| Field | Type | Required | Description |
|---|---|---|---|
email | string | Yes | Email address |
role | string | Yes | viewer, reviewer, author, or admin |
Requires admin role. Sends an invitation email.
Update Member Role
PATCH /api/v1/orgs/{slug}/members/{id}Remove Member
DELETE /api/v1/orgs/{slug}/members/{id}API Keys
See Authentication > API Keys for usage details.
# List keys (admin only)
GET /api/v1/orgs/{slug}/api-keys
# Create key (admin only, returns plaintext once)
POST /api/v1/orgs/{slug}/api-keys
{ "name": "Production Backend" }
# Revoke key
DELETE /api/v1/orgs/{slug}/api-keys/{id}