Skip to main content
POST
Create Workspace
Any logged-in account can call this — creation itself isn’t gated by a permission, it’s gated by plan. An API key needs the workspaces:write scope.
Four seed roles are created with the workspace: Admin (every permission except snapshots:manage — restoring/deleting a snapshot is too destructive to grant by default), Developer, Operator and Viewer. They’re ordinary roles from the moment they’re created — renamable, editable, deletable — and count toward the plan’s role cap like any other.

Body

string
required
1–50 characters. Unique per owner among your active (non-deleted) workspaces.
string
Up to 200 characters.

Response

Same shape as Get Workspace minus members/roles/applications/databases/permissions/is_owner — see List Workspaces for the fields.

Errors