Skip to main content
POST
Create Dashboard Workspace

Authorizations

Authorization
string
header
required

Logged-in user-session JWT authentication for first-party clients. Org-scoped requests also require the Replicas-Org-Id header. User JWTs cannot create workspaces with POST /v1/replica.

Body

application/json

Dashboard workspace creation request.

environment_id
string<uuid>
required

Environment whose repository binding and configuration the workspace uses.

name
string

Optional workspace name. A placeholder is generated when omitted.

repository_branches
object

Optional starting-branch overrides keyed by repository UUID. Every repository must belong to the selected environment. Omitted repositories use their configured default branch.

config
object

Workspace behavior configuration. Missing capabilities and preferences default to disabled.

size
enum<string>
Available options:
small,
large

Response

Workspace created

workspace
object
required

A workspace returned by the dashboard workspace list.