Endpoints
Endpoint details are saved from the OpenAPI document. Authentication requirements and prices are advertised information, not a verified payment or access guarantee. The document may contain additional endpoints.GET/smolmachines/v1/machines
List all machines. Use to discover existing machine IDs for recovery or cleanup.
Price unavailablePOST/smolmachines/v1/machines
Create a new microVM. Minimal example: {"source":{"type":"image","reference":"alpine:3.20"},"resources":{"cpus":1,"memoryMb":51…
Price unavailableDELETE/smolmachines/v1/machines/{id}
Permanently delete a machine and its storage
Price unavailableGET/smolmachines/v1/machines/{id}
Get machine details and status. Poll until ready is true before executing commands.
Price unavailablePOST/smolmachines/v1/machines/{id}/code
Run Python or JavaScript code directly in a machine
Price unavailableGET/smolmachines/v1/machines/{id}/events
Get machine event log
Price unavailablePOST/smolmachines/v1/machines/{id}/exec
Run a command inside a machine. Pass command as a shell string ("ls -la") or argv array (["ls","-la"]). Machine must be ready b…
Price unavailableGET/smolmachines/v1/machines/{id}/files
Download a file from a machine
Price unavailablePOST/smolmachines/v1/machines/{id}/files
Upload a file to a machine
Price unavailableGET/smolmachines/v1/machines/{id}/sessions
List sessions for a machine
Price unavailablePOST/smolmachines/v1/machines/{id}/sessions
Create a persistent session that preserves working directory and environment across exec calls
Price unavailableDELETE/smolmachines/v1/machines/{id}/sessions/{session_id}
Delete a session
Price unavailablePOST/smolmachines/v1/machines/{id}/sessions/{session_id}/exec
Execute a command within a persistent session. Session preserves working directory and environment across calls.
Price unavailablePOST/smolmachines/v1/machines/{id}/start
Start a stopped machine
Price unavailablePOST/smolmachines/v1/machines/{id}/stop