DocsAPI ReferenceCreate a workspace
POST/api/v1/workspaces

Creates a new workspace with the given name and optional settings.

Headers

X-API-Keystringrequired

Your workspace API key.

Content-Typestringrequired

Must be `application/json`.

Request Body

application/json

namestringrequired

Display name (1–255 chars).

Example: "Marketing Team"

slugstring

URL slug (max 100, auto-generated from name if omitted).

Example: "marketing-team"

Responses

201Workspace created.
{
  "id": "bbbbbbbb-0000-0000-0000-000000000001",
  "name": "Marketing Team",
  "slug": "marketing-team",
  "settings": {},
  "created_at": "2026-05-12T10:00:00Z",
  "updated_at": "2026-05-12T10:00:00Z"
}
409Slug already taken.