Endpoints
Get fleet results
Poll an asynchronous fleet creation for ordered member results.
GET
/
v2
/
sandboxes
/
fleets
/
{id}
curl --request GET \
--url "https://api.bead.run/v2/sandboxes/fleets/$FLEET_ID" \
--header "X-API-Key: $BEAD_API_KEY"
{
"results": [
{
"index": 123,
"status": 123,
"operationID": "<string>",
"response": {
"alias": "<string>",
"clientID": "<string>",
"domain": {},
"envdAccessToken": "<string>",
"envdVersion": "<string>",
"grace_deadline": {},
"idle_timeout": {},
"kind": "<string>",
"last_activity": {},
"machine_state": "<string>",
"paused_at": {},
"sandboxID": "<string>",
"templateID": "<string>",
"trafficAccessToken": {},
"wake_reason": {},
"warnings": [
{}
],
"code": 123,
"message": "<string>",
"error_code": "<string>",
"limit": {
"limit": "<string>",
"maximum": 123,
"usage": 123,
"next_action": "<string>",
"reset_at": 123
},
"operationID": "<string>",
"status": "<string>"
}
}
],
"fleetID": "<string>",
"status": "<string>"
}Authentication
Send your scoped bearer token in theAuthorization: Bearer <BEAD_TOKEN> header, or send your API key in X-API-Key.
Parameters
string
required
UUID of the fleet operation. Format:
uuid.curl --request GET \
--url "https://api.bead.run/v2/sandboxes/fleets/$FLEET_ID" \
--header "X-API-Key: $BEAD_API_KEY"
Response
200
Current results for each requested machine.object[]
required
One result per requested machine.
Show Properties
Show Properties
integer
required
Zero-based request index.
integer
required
HTTP status for this member; 202 means it is still pending.
string
Operation UUID for a pending member.
object
Machine connection fields on success, or an error body on failure. Accepts
object or object or object.Show Properties
Show Properties
string
Alias of the template
string
deprecated
Identifier of the client
string | null
Base domain where the sandbox traffic is accessible May be
null.string
Access token used for envd communication
string
Version of the envd running in the sandbox
string | null
End of the credit grace period as an RFC 3339 timestamp, or null when funded. May be
null.integer | string | null
Seconds without activity before a persistent machine pauses, or never to disable idle pause. Persistent machines default to 900 seconds; numeric values must be 300–86400. May be
null. Accepts integer or string (“never”).string
Lifetime policy: temporary expires at its timeout; persistent retains state until explicit deletion or the end of credit grace. Allowed values:
"temporary", "persistent".string | null
Most recent activity as an RFC 3339 timestamp, or null when no activity was recorded. May be
null.string
Current lifecycle state including running, idle-paused, waking, credit-grace, lost, or deleted. Allowed values:
"running", "idle-paused", "waking", "credit-grace", "lost", "deleted".string | null
Time the machine last paused as an RFC 3339 timestamp, or null when it has not paused. May be
null.string
Identifier of the sandbox
string
Identifier of the template from which is the sandbox created
string | null
Token required for accessing sandbox via proxy. May be
null.string | null
Reason for the last wake or lifecycle transition, or null when none is recorded. May be
null.object[]
Lifecycle or credit grace warnings attached to this machine. Additional keys accept
any values.integer
HTTP status code.
string
Explanation of the failed request.
string
Stable error identifier when supplied; use it to decide how to recover.
object
The resource limit that blocked the request.
string
Operation UUID.
string
Current operation state.
string
required
Fleet UUID supplied in the polling URL.
string
required
Whether every member has finished. Allowed values:
"pending", "completed".Errors
| Status | Meaning |
|---|---|
| 400 | Invalid resource UUID or request parameters. |
| 401 | Authentication credential is missing or rejected. |
| 403 | The credential lacks the required scope. |
| 404 | The requested resource does not exist or is outside your organization. |
| 429 | Request or resource admission limit exceeded (admission_limit). Follow limit.next_action and Retry-After when present. |
| 503 | Service or persistence is temporarily unavailable. |
⌘I
curl --request GET \
--url "https://api.bead.run/v2/sandboxes/fleets/$FLEET_ID" \
--header "X-API-Key: $BEAD_API_KEY"
{
"results": [
{
"index": 123,
"status": 123,
"operationID": "<string>",
"response": {
"alias": "<string>",
"clientID": "<string>",
"domain": {},
"envdAccessToken": "<string>",
"envdVersion": "<string>",
"grace_deadline": {},
"idle_timeout": {},
"kind": "<string>",
"last_activity": {},
"machine_state": "<string>",
"paused_at": {},
"sandboxID": "<string>",
"templateID": "<string>",
"trafficAccessToken": {},
"wake_reason": {},
"warnings": [
{}
],
"code": 123,
"message": "<string>",
"error_code": "<string>",
"limit": {
"limit": "<string>",
"maximum": 123,
"usage": 123,
"next_action": "<string>",
"reset_at": 123
},
"operationID": "<string>",
"status": "<string>"
}
}
],
"fleetID": "<string>",
"status": "<string>"
}