API Reference
API reference
Every endpoint of the Platinum REST API, generated from the OpenAPI spec. Open any operation and send a real request from the playground.
audit1
secrets8
volumes34
DELETEDELETE /v1/volumes/{v}DELETEDELETE /v1/volumes/{v}/filesDELETEDELETE /v1/volumes/{v}/files/upload/{uploadId}DELETEDELETE /v1/volumes/{v}/tags/{tag}GETGET /v1/volumesGETGET /v1/volumes/{v}GETGET /v1/volumes/{v}/commitsGETGET /v1/volumes/{v}/commits/{ref}GETGET /v1/volumes/{v}/conflictsGETGET /v1/volumes/{v}/diffGETGET /v1/volumes/{v}/filesGETGET /v1/volumes/{v}/files/contentGETGET /v1/volumes/{v}/files/statGETGET /v1/volumes/{v}/files/uploadGETGET /v1/volumes/{v}/healthGETGET /v1/volumes/{v}/mountsGETGET /v1/volumes/{v}/mounts/{mount}/waitGETGET /v1/volumes/{v}/tagsGETGET /v1/volumes/{v}/waitGETGET /v1/volumes/limitsPATCHPATCH /v1/volumes/{v}POSTPOST /v1/volumesPOSTPOST /v1/volumes/{v}/commitPOSTPOST /v1/volumes/{v}/files/copyPOSTPOST /v1/volumes/{v}/files/movePOSTPOST /v1/volumes/{v}/files/uploadPOSTPOST /v1/volumes/{v}/files/upload/{uploadId}/commitPOSTPOST /v1/volumes/{v}/forkPOSTPOST /v1/volumes/{v}/heartbeatPOSTPOST /v1/volumes/{v}/restorePUTPUT /v1/volumes/{v}PUTPUT /v1/volumes/{v}/files/contentPUTPUT /v1/volumes/{v}/files/upload/{uploadId}/blocks/{sha}PUTPUT /v1/volumes/{v}/tags/{tag}
workers7
Sandboxes56
DELETEDELETE /v1/sandboxes/{id}DELETEDELETE /v1/sandboxes/{id}/expose/{port}DELETEDELETE /v1/sandboxes/{id}/secrets/{alias}DELETEDELETE /v1/sandboxes/{id}/snapshots/{snapId}DELETEDELETE /v1/sandboxes/{id}/volumes/{mount}GETGET /v1/sandboxesGETGET /v1/sandboxes/{id}GETGET /v1/sandboxes/{id}/agentGETGET /v1/sandboxes/{id}/childrenGETGET /v1/sandboxes/{id}/logsGETGET /v1/sandboxes/{id}/metricsGETGET /v1/sandboxes/{id}/networkGETGET /v1/sandboxes/{id}/secretsGETGET /v1/sandboxes/{id}/snapshotsGETGET /v1/sandboxes/{id}/usageGETGET /v1/sandboxes/{id}/volumesGETGET /v1/sandboxes/{id}/volumes/{mount}GETGet one managed process (?wait_ms= to block until exit)GETInteractive terminal (WebSocket PTY)DELETEKill a process (record retained)GETList managed processes (incl. recently exited)PATCHPATCH /v1/sandboxes/{id}PATCHPATCH /v1/sandboxes/{id}/envPOSTPOST /v1/sandboxesPOSTPOST /v1/sandboxes/{id}/agent/upgradePOSTPOST /v1/sandboxes/{id}/archivePOSTPOST /v1/sandboxes/{id}/backupPOSTPOST /v1/sandboxes/{id}/clonePOSTPOST /v1/sandboxes/{id}/egress-policyPOSTPOST /v1/sandboxes/{id}/exposePOSTPOST /v1/sandboxes/{id}/expose/revokePOSTPOST /v1/sandboxes/{id}/forkPOSTPOST /v1/sandboxes/{id}/movePOSTPOST /v1/sandboxes/{id}/networkPOSTPOST /v1/sandboxes/{id}/pausePOSTPOST /v1/sandboxes/{id}/resizePOSTPOST /v1/sandboxes/{id}/restorePOSTPOST /v1/sandboxes/{id}/restore-from-backupPOSTPOST /v1/sandboxes/{id}/resumePOSTPOST /v1/sandboxes/{id}/snapshotPOSTPOST /v1/sandboxes/{id}/ssh-keysPOSTPOST /v1/sandboxes/{id}/startPOSTPOST /v1/sandboxes/{id}/stopPOSTPOST /v1/sandboxes/{id}/volumes/{mount}POSTPOST /v1/sandboxes/{id}/volumes/{mount}/commitPOSTPOST /v1/sandboxes/{id}/volumes/{mount}/pullPOSTPOST /v1/sandboxes/sweep-failedPUTPUT /v1/sandboxes/{id}/secretsGETRead process output by absolute offsetPOSTResize a PTY process’s windowPOSTRun a code snippet (python | bash | node | sh)POSTRun a command (argv, no shell)POSTSignal a process (group by default)POSTStart a managed process (outlives the request)GETStream process output (SSE)POSTWrite to a process’s stdin (or close it)
Files11
POSTCreate a directory (recursive, ?path= & ?mode=)DELETEDelete a file or directory (?recurse=true)GETDownload a file (raw bytes)GETFind files by name globPOSTFind-and-replace across files (sed -E)GETList a directoryPUTPUT /v1/sandboxes/{id}/files/atomicGETSearch file contents (recursive grep)GETStat a path (size, mode, mtime)PUTUpload a file (raw body, ?path= & ?mode=)GETWatch a directory for changes (SSE)
Templates15
DELETEDELETE /v1/templates/{id}GETGET /v1/templatesGETGET /v1/templates/{id}PATCHPATCH /v1/templates/{id}POSTPOST /v1/templatesPOSTPOST /v1/templates/{id}/cancelPOSTPOST /v1/templates/{id}/derivePOSTPOST /v1/templates/{id}/materializePOSTPOST /v1/templates/{id}/preparePOSTPOST /v1/templates/from-buildPOSTPOST /v1/templates/from-build/presignPOSTPOST /v1/templates/from-imagePOSTPOST /v1/templates/from-patchPOSTPOST /v1/templates/from-snapshotPOSTPOST /v1/templates/from-spec
Webhooks7
Inference3
Platform2