AI Applications

Update desired application workspace resources

Persists desired runtime and resource settings server-side, then replaces compute while retaining the application files.

patch/ai/applications/{application_public_id}/workspace

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
  • Auth: HTTP bearer

Path parameters

application_public_idstring required

Request body

cpu_limitnumber double nullable
disk_limit_mbinteger nullable
idle_timeout_secsinteger nullable
imagestring nullable

Pinned Temps-managed daemon image. Empty string restores the runtime default. Omit to leave the selected image unchanged. Arbitrary images are rejected.

memory_limit_mbinteger nullable
pids_limitinteger nullable
runtimestring 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.