Create a workspace.
Creates a cloud workspace and first session, optionally queues its initial message, and returns a deep link that opens the workspace in the Conductor desktop app. When a message is included, the response's initialMessage contains its ID and whether it was sent or queued; if the message could not be accepted, the workspace and session are still created and initialMessage is omitted — resend it via the messages endpoint. Creation is not idempotent: retrying a request whose response was lost creates another workspace. Pass either projectId or repositoryUrl. With an organization API key, the workspace launches on the organization's machine; the machine must include the repository. Omit agent and model to use the caller's default model as saved in the Conductor app (the first favorite in the model picker), including its effort and fastMode unless those are sent explicitly. When no default is saved, or its agent has no connected credentials, the agent defaults to codex and the model to the agent's default — claude: opus-5-1m; codex: gpt-6.1-sol; cursor: composer-2.5. Accepted model ids by agent — claude: fable-5-1, fable-5, opus-5-5-1m, opus-5-1m, opus-4-8-1m, opus-4-8, opus-4-7-1m, opus-4-7, opus-4-6-1m, sonnet-5-5-1m, sonnet-5-1m, sonnet-4-6-1m, sonnet-4-6, haiku-5-5-1m, haiku-4-5; codex: gpt-5.5, gpt-5.4, gpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna, gpt-5.3-codex-spark, gpt-5.3-codex, gpt-5.2-codex, gpt-6-astra, gpt-6.1-sol, gpt-6-sol, gpt-6-luna, gpt-daybreak-blue-latest; cursor: auto, composer-2.5, grok-4.7, grok-4.6, grok-4.5. Accepted effort levels by agent — claude: low, medium, high, xhigh, max, ultracode; codex: none, low, medium, high, xhigh, max, ultra; cursor: low, medium, high, xhigh; codex max and ultra, and claude ultracode, require support from the selected model. Omit effort to use the agent's default — claude: high; codex: high. Models accepting fastMode by agent — claude: opus-5-5-1m, opus-5-1m, opus-4-8-1m, opus-4-8, opus-4-7-1m, opus-4-7, opus-4-6-1m; codex: gpt-5.5, gpt-5.4, gpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna, gpt-5.3-codex-spark, gpt-5.3-codex, gpt-5.2-codex, gpt-6-astra, gpt-6.1-sol, gpt-6-sol, gpt-6-luna, gpt-daybreak-blue-latest; cursor: auto, composer-2.5, grok-4.7, grok-4.6, grok-4.5. Omit fastMode (or send false) for other models.
Request
- Base URLhttps://api.conductor.build (the document declares no server; this is the origin it was published from)
- URLhttps://api.conductor.build/v0/workspaces
- AuthHTTP bearer
Query parameters
Desktop-app channel the returned deepLink should open. Defaults to the deployment's primary channel.
Request body
Response
Default Response
Changes
No recorded changes to this operation across all 1 revision of this API.