{"uid":"cap_HaTck9hvRjmEJAVEiG9V5","slug":"reachpad-router-disposable-linux-vm-provisioner-6fcd9253","name":"Reachpad Router – Disposable Linux VM Provisioner","description":"Virtual machines for agents: disposable Linux VMs, sandboxes and dev servers — ask for cpu, RAM, disk and region, get the cheapest eligible cloud provider, run commands over SSH or exec, pay per second in credits funded by USDC (x402) or card.","url":"https://router.reachpad.dev/v1/machines","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"input":{"type":"object","properties":{"body":{"type":"object","required":["cpu","ram_gb","disk_gb","region"],"properties":{"cpu":{"type":"number","minimum":0.25,"description":"vCPUs. An offer must meet or exceed it."},"access":{"type":"array","items":{"enum":["ssh","exec"],"type":"string"},"default":["ssh"],"minItems":1,"description":"The access set. \"ssh\" gives a hostname and needs ssh_public_key; \"exec\" gives POST /v1/machines/{id}/exec with no key and no hostname.","uniqueItems":true},"ram_gb":{"type":"number","minimum":0.25,"description":"Memory in GB."},"region":{"enum":["us-west","us-east","eu-central"],"type":"string","description":"Matched exactly against the offer."},"disk_gb":{"type":"number","minimum":0.25,"description":"Disk in GB."},"max_rate":{"type":"string","pattern":"^\\d+(\\.\\d{1,6})?$","description":"Drop any offer whose hourly rate is above this. Decimal USD as a string, e.g. \"0.15\"."},"issue_key":{"type":"boolean","description":"Ask this payment to return the account's API key. Needs a payment on the request, freshly signed (its validity must end within 10 minutes), and spends one of the wallet's ten re-issues per five minutes. Rotates the key of an account that already exists (the old key stops working) and returns the new one; on the payment that creates the account the key comes back anyway. Last rotation wins, so never send two flagged payments in parallel."},"max_spend":{"type":"string","pattern":"^\\d+(\\.\\d{1,6})?$","description":"Destroy the machine when its accrued spend reaches this budget. Decimal USD as a string, e.g. \"0.15\"."},"client_ref":{"type":"string","maxLength":128,"minLength":1,"description":"Your idempotency key, unique per account. A retry carrying a ref that already names one of your machines returns that machine instead of provisioning again."},"ttl_seconds":{"type":"integer","minimum":1,"description":"The machine is destroyed at expiry. Default 14400 (4 hours)."},"ssh_public_key":{"type":"string","description":"An OpenSSH public key (\"ssh-ed25519 AAAA...\"). Required when access includes \"ssh\"."}},"additionalProperties":false}}},"output":{"type":"object","properties":{"example":{"id":"rp_vm_abc123def4","host":"rp_vm_abc123def4.reachpad.dev","access":["ssh"],"region":"us-west","status":"ready","api_key":"rp_key_… (present whenever key_issued is not false)","provider":"daytona","ssh_user":"reachpad","created_at":"2026-09-02T00:00:00.000Z","expires_at":"2026-09-02T04:00:00.000Z","key_issued":"created","rate_per_hour":"0.0666"}}}}},"responseSchema":{"type":"json","example":{"id":"rp_vm_abc123def4","host":"rp_vm_abc123def4.reachpad.dev","access":["ssh"],"region":"us-west","status":"ready","provider":"daytona","ssh_user":"reachpad","created_at":"2026-09-02T00:00:00.000Z","expires_at":"2026-09-02T04:00:00.000Z","rate_per_hour":"0.0666"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_wVgGs10mSq_WXPx1lXKxC","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"1","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Provisions an on-demand disposable Linux VM (sandbox or dev server) by selecting the cheapest cloud provider meeting your CPU, RAM, disk, and region requirements, returning SSH or exec access credentials, billed per second via USDC or card.","exampleAgentPrompt":"Spin up a disposable Linux VM for me with 2 vCPUs, 4 GB RAM, and 20 GB disk in us-east — I need SSH access, so here's my public key: ssh-ed25519 AAAA... — keep it alive for 2 hours and don't let the hourly rate exceed $0.15.","exampleUseCases":[{"title":"Sandboxed code execution for agent pipeline","prompt":"Spin up a throwaway Linux box with 1 vCPU, 2 GB RAM, and 10 GB disk in us-west using exec access — no SSH key needed — and destroy it after 30 minutes. I need to run some untrusted Python code safely."},{"title":"Temporary CI build server on a budget","prompt":"Provision a Linux VM with 4 vCPUs, 8 GB RAM, and 50 GB disk in eu-central over SSH — here's my public key: ssh-ed25519 AAAA... — cap the hourly rate at $0.20 and shut it down automatically after 3 hours."},{"title":"Idempotent dev server for reproducible agent tasks","prompt":"Create a dev server with 2 vCPUs, 4 GB RAM, and 20 GB disk in us-east via SSH, using client ref 'build-job-42' so if my agent retries it doesn't double-provision — public key is ssh-ed25519 AAAA.... Limit total spend to $0.50."}],"resultDescription":"A JSON object containing the machine ID, fully-qualified hostname (for SSH), assigned SSH user, cloud provider selected, region, current status ('ready'), access methods, creation and expiry timestamps, and the hourly rate in decimal USD. The agent can immediately connect via SSH to the hostname or send POST requests to /v1/machines/{id}/exec for exec-mode machines.","failureModes":["No eligible provider found matching CPU/RAM/disk/region constraints — returns an error with no machine created","ssh_public_key missing when access includes 'ssh' — validation error","region value not in enum [us-west, us-east, eu-central] — 400 bad request","max_rate too low to match any offer — no machine provisioned","Idempotency key (client_ref) collision on a different account — error or unexpected machine returned","Payment failure (insufficient USDC credits or card declined) — provisioning blocked","TTL expires before agent can use the machine — machine destroyed"],"whenToPreferThis":"Choose this endpoint when an AI agent needs an isolated, ephemeral Linux compute environment to run arbitrary commands, build software, or execute untrusted code — especially when you want least-cost provider routing across multiple clouds without managing provider accounts directly. Prefer it over static cloud VMs when you need per-second billing, automatic expiry, and idempotent provisioning via client_ref. It is purpose-built for agent workflows that need real compute sandboxes rather than simulated or containerized environments managed by the caller.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:31:15.926Z","isFirstParty":false}