List Agent VMs

GET/compute/v1/vms

Returns VMs scoped to the caller's org

Query parameters

stateoptional string

Filter by state

tieroptional string

Filter by tier

limitoptional integer

Limit results

offsetoptional integer

Offset results

Headers

Authorizationstring

Bearer <token>. STS access token. Obtain via POST https://sts.hexelstudio.com/token with X-API-Key header.

Returns

200OKarray of AgentVM

allocated_atoptional string

created_atoptional string

expires_atoptional string

idoptional string

metadataoptional map[string]

released_atoptional string

skillsoptional array of string

stateoptional string

tieroptional string

tokenoptional string

ttl_secondsoptional integer

Errors

500Internal Server Error

const res = await fetch("https://compute.hexelstudio.com/compute/v1/vms", { method: "GET", headers: { Authorization: `Bearer ${process.env.ACCESS_TOKEN}`, }, }) const data = await res.json()

[ { "allocated_at": "2026-01-01T00:00:00Z", "created_at": "2026-01-01T00:00:00Z", "expires_at": "2026-01-01T00:00:00Z", "id": "string", "metadata": { "key": "string" }, "released_at": "2026-01-01T00:00:00Z", "skills": [ "string" ], "state": "string", "tier": "string", "token": "string", "ttl_seconds": 0 } ]