Sign in

v54

latestSwagger 2.0AGPL-3.0raw.githubusercontent.com2026-08-03397565628.8 KB
Builds

Create workspace build

post/api/v2/workspaces/{workspace}/builds

Path parameters

workspacestring uuid required

Workspace ID

Request body

dry_runboolean
log_level'debug'
orphanboolean

Orphan may be set for the Destroy transition.

reason'dashboard' | 'cli' | 'ssh_connection' | 'vscode_connection' | 'jetbrains_connection' | 'task_manual_pause' | 'task_resume'
stateinteger[]
template_version_idstring uuid
template_version_preset_idstring uuid

TemplateVersionPresetID is the ID of the template version preset to use for the build.

transition'start' | 'stop' | 'delete' required

Response

OK

build_numberinteger
created_atstring date-time
daily_costinteger
deadlinestring date-time
has_ai_taskboolean

Deprecated: This field has been deprecated in favor of Task WorkspaceID.

has_external_agentboolean
idstring uuid
initiator_idstring uuid
initiator_namestring
max_deadlinestring date-time
reason'initiator' | 'autostart' | 'autostop' | 'dormancy' | 'dashboard' | 'cli' | 'ssh_connection' | 'vscode_connection' | 'jetbrains_connection' | 'task_auto_pause' | 'task_manual_pause' | 'task_resume'
status'pending' | 'starting' | 'running' | 'stopping' | 'stopped' | 'failed' | 'canceling' | 'canceled' | 'deleting' | 'deleted'
template_version_idstring uuid
template_version_namestring
template_version_preset_idstring uuid
transition'start' | 'stop' | 'delete'
updated_atstring date-time
workspace_idstring uuid
workspace_namestring
workspace_owner_avatar_urlstring
workspace_owner_idstring uuid
workspace_owner_namestring

WorkspaceOwnerName is the username of the owner of the workspace.

Example response

{
  "resources": [
    {
      "agents": [
        {
          "health": {
            "reason": "agent has lost connection"
          }
        }
      ]
    }
  ]
}