AI Applications

Control an application workspace

Restart, pause, resume, rebuild, snapshot, or restore the application's persistent workspace. Files outlive suspended or replaced compute.

post/ai/applications/{application_public_id}/workspace/actions

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/ai/applications/{application_public_id}/workspace/actions
  • Auth: HTTP bearer

Path parameters

application_public_idstring required

Request body

actionstring required

restart, pause, resume, rebuild, snapshot, restore, or update_runtime

confirmboolean nullable

Must be true for update_runtime because compute is replaced.

labelstring nullable
runtimestring nullable

Optional built-in flavor to select during update_runtime.

snapshot_idstring nullable

Response

cpu_limitnumber double required
cpu_usage_usecinteger nullable
data_network_service_countinteger required
desired_statestring required
disk_limit_enforcedboolean required

Docker bind-mounted workspaces report usage but cannot enforce a per-directory quota. Firecracker workspaces enforce this value.

disk_limit_mbinteger required
disk_used_bytesinteger nullable
idle_timeout_secsinteger required
imagestring nullable
last_errorstring nullable
memory_limit_mbinteger required
memory_used_bytesinteger nullable
open_preview_portsinteger[] required
persistent_volume_healthyboolean required
pids_limitinteger required
pids_usedinteger nullable
runtimestring required
runtime_compatibleboolean nullable
runtime_update_availableboolean required
runtime_update_errorstring nullable
runtime_update_imagestring nullable
sandbox_public_idstring nullable
snapshot_idstring nullable
statestring required

Changes

No recorded changes to this operation across all 54 revisions of this API.