latestOpenAPI 3.1.02026-08-149289225.1 KB
664536fccd0e
Sandboxes
Create a sandbox
post/api/v0beta1/sandboxes
Request body
namestring required
repo_urlstring
git_urlstring
github_urlstring
branchstring
new_branch_namestring
provider'daytona' | 'freestyle' | 'vercel'
auto_stop_intervalnumber
auto_delete_intervalnumber
env_varsobject
secret_env_varsobject
disabled_repo_env_var_namesstring[]
setup_script_textstring
skip_setup_scriptboolean
preset'coder' | 'coder-dind'
size'xs' | 'm' | 'l' | 'xl'
snapshotstring nullable
integration_idsstring[]
initial_promptstring
agent'claude' | 'codex'
github_auth_mode'pat' | 'app_token'
Response
Sandbox created (provisioning continues in the background).
idstring required
user_idstring nullable required
org_idstring required
namestring required
providerstring nullable required
provider_sandbox_idstring nullable required
provider_urlstring nullable required
amika_opencode_webstring nullable required
repo_namestring nullable required
repo_providerstring nullable required
repo_idstring nullable required
repo_urlstring nullable required
branchstring nullable required
commit_hashstring nullable required
snapshotstring nullable required
snapshot_namestring nullable
sandbox_presetstring nullable
sandbox_sizestring nullable
error_messagestring nullable
current_session_idstring nullable required
statestring
status'creating' | 'starting' | 'running' | 'stopping' | 'suspending' | 'suspended' | 'snapshotting' | 'failed' | 'unknown'
setup_status'ok' | 'setup-running' | 'git-failed' | 'setup-failed' | 'sys-setup-failed' | 'null' nullable
secret_namesstring[]
has_workflowboolean
originstring nullable