Sandbox list
GET
https://api.todofor.ai/api/v1
/sandboxes
List the authenticated user's sandboxes.
Responses
Successful response
idstring · requireduser_idstring · requiredtemplatestring · requiredstaterequiredSandbox lifecycle state change. Published by sandbox-manager on Redis (
sandbox:events:<userId>), re-emitted by backend to subscribed frontends.- On create/pause/resume/error/terminate:
sandboxholds the full record. - On delete:
deleted: trueandsandboxis omitted; frontend drops the row.
- On create/pause/resume/error/terminate:
ip_addressrequiredtap_devicerequiredpidrequiredcreated_atnumber · requiredlast_activitynumber · requirederrorrequired
kindDefaults to 'vm' for legacy records that pre-date the field.
sizeVmSize tier; not modelled in TS — frontend passes through as-is.
device_idstringId of the backend Device row representing this sandbox's bridge. Lite: set at create time. VM: set after the bridge enrolls and the backend calls
attach-device. Absent when not yet linked.