Agent ID (agt_...). When provided, only computers belonging to this agent are returned.
Request body.
Optionalconfig?: Record<string, unknown>Provider-specific configuration for the computer. Supported keys vary by provider. A top-level provider takes precedence over config.provider.
Optionallookup_key?: stringStable, user-defined key for this computer. Must be unique within the app. Use it to look up the computer without storing its ID.
Optionalmetadata?: Record<string, unknown>Arbitrary key-value metadata to attach to the computer. Not interpreted by the platform; returned as-is on all subsequent reads.
Human-readable display name for the computer.
Optionalprovider?: stringCompute backend for the computer: "sprites" (Fly Sprites, the default) or "vercel" (Vercel Sandbox). Folded into config.provider.
Optionalregion?: stringRegion in which to provision the computer, e.g. "iad". Defaults to "iad" when omitted.
The newly provisioned computer.
List computers
Returns all computers belonging to the authenticated app, ordered by creation
time descending. Pass agent to scope the results to a single agent's
computers. When agent is omitted, computers for all agents in the app are
returned.
Requires an app-scoped API key. If the specified agent does not exist or does
not belong to the app, the endpoint returns 404.
Agent ID (agt_...). When provided, only computers belonging to this agent are returned.
Object containing a data array of computer records.
Provision a computer for an agent Creates and provisions a new computer resource associated with the specified agent. The computer is allocated in the requested region (defaulting to
iad) and its status transitions fromprovisioningtorunningonce it is ready. Requires an app-scoped API key. The agent identified byagentmust belong to the same app. Supplying alookup_keylets you retrieve this computer later without storing its ID — the key must be unique within the app.