capabilities.work

Provision Devbox and Run a Command

A 4-step recipe with Runloop. We can help you get access.

Recipe · 4 steps

Provision Devbox and Run a Command

with Runloop · Environment Management

Boot a devbox and run a command on it once it is ready.

  1. Create a devbox; it begins booting in the provisioning state.
  2. Poll the devbox lifecycle until it reports the running status, branching back to retry while it is still provisioning or initializing.
  3. Launch the supplied command asynchronously on the running devbox.
  4. Wait for the asynchronous execution to reach the completed status.
What you'll need to have ready
  • apiToken: Runloop API bearer token.
  • name: Optional friendly name for the devbox.
  • blueprintId: Optional blueprint id to base the devbox on.
  • command: The shell command to execute on the devbox.
  • commandId: A client supplied UUIDv7 command id for idempotency and tracking.
For your developer

Arazzo workflow runloop-ai:provision-and-run-command, 4 operations: createDevbox → waitForDevboxStatus → execAsyncCommand → waitForCommandCompletion. Specs on APIs.io.