Creating Organizations

Organizations group users within an application. The user who creates an organization automatically becomes its first admin.

From the Dashboard

Open an application in the dashboard.
Go to User Management → Organizations.
Click Create organization and fill in the name, slug, and optional logo/metadata.
You'll be taken to the new organization's detail page, where you can invite members.

Property	Description
`name`	Display name. 1–255 characters.
`slug`	URL-friendly identifier, unique within the application. 3–63 characters, lowercase letters, numbers, and hyphens. Must start with a letter and contain no consecutive hyphens.
`logo_url`	Optional HTTPS URL to the organization's logo.
`metadata`	Optional free-form JSON object for application-specific data.

POST /api/organizations

{
  "name": "Acme Corp",
  "slug": "acme-corp",
  "logo_url": "https://example.com/logo.png",
  "metadata": { "plan": "pro" }
}

Returns 201 with the created organization. The caller becomes its first admin in a single transactional batch.

GET /api/organizations?page=1&limit=20

Returns only the organizations the current user is a member of, paginated.

GET /api/organizations/:id

Returns 404 if the caller is not a member.

PUT /api/organizations/:id

{
  "name": "Acme Corporation",
  "logo_url": "https://example.com/new-logo.png"
}

Admin-only. At least one field must be provided.

DELETE /api/organizations/:id

Admin-only. Deletes the organization, all memberships, and all invitations via cascading deletes. User accounts are not deleted.