Skip to main content
POST
Provision a compute instance

Body

application/json
plan
string
required
region
string
required
os_id
integer
required
label
string
hostname
string
prepaid_hours
integer

Prepaid runtime in hours (minimum 24). Provision uses prepaid_hours; the extend endpoint uses extend_hours.

Required range: x >= 24
use_credits
boolean

Pay from prepaid USD credits instead of an x402 wallet payment. Supported for bare and grid machines. NOT supported for ai_machine (private AI Machines require an x402 wallet payment).

provider
enum<string>

Optional provider hint. Plan IDs with do: prefix resolve to DigitalOcean.

Available options:
vultr,
digitalocean
network
enum<string>

x402 payment network. Robinhood Chain settles in USDG; Base and MegaETH settle in USDC; Solana settles in USDC. MPP clients use Authorization: Payment and do not need this field.

Available options:
base,
solana,
megaeth,
robinhood
ssh_public_key
string
user_data
string

Optional cloud-init user data run at first boot.

ai_machine
object

Private AI Machine (Standard tier). When present, the machine self-installs the pinned LLM behind your own OpenAI-compatible endpoint (URL + API key), running llama-server (llama.cpp) on port 8080 exposing /v1 (/v1/chat/completions and /v1/models). Supports x402, MPP, or prepaid credits. Mutually exclusive with deploy_node.

deploy_node
object

Join the grid. When present, the machine self-installs as a network node owned by the paying wallet, earning USDC + SGL (requires 50,000 SGL staked). Requires an x402 Solana payment. Mutually exclusive with ai_machine.

Response

Provisioning started