GET /managed-services/instances
List your account's managed service instances, including pending and retired instances.
Syntax
GET https://grid-lab.zyxio.xyz/managed-services/instances
x-api-key: <key>Request
| Name | Where | Required | Meaning |
|---|---|---|---|
x-api-key | header | yes, or Authorization | Your API key, or Authorization: Bearer <token> from Zyxio sign-in. |
No body or query parameters are needed. The authenticated account determines the list; you cannot select another account. All identities of the same account see its instances.
Response
200 OK, with cache-control: no-store.
| Field | Meaning |
|---|---|
schemaVersion | Always managed-service-instance-list/v1. |
instances | An array of instance records, newest creation first. Empty when your account has none. |
Every array entry has the fields described by GET /managed-services/instances/{instanceId}. The list includes all lifecycle states and contains no credential secrets. This endpoint has no pagination.
Errors
| Status | Body | When | What to do |
|---|---|---|---|
401 | {"error": "unauthorized"} | Missing, revoked, expired or invalid API key. | Send a valid key. |
403 | {"error": "forbidden"} | A sign-in token has no usable account. | Use an invited account or its API key. |
403 | {"error": "managed_service_account_required"} | The caller has no active, allocated account. | Check the account used by your credential. |
503 | {"error": "accounting_unavailable"} | Authentication could not check the account database. | Retry shortly. |
503 | {"error": "managed_service_unavailable"} | A service dependency failed or did not answer. | Retry shortly; read current status before repeating a change. |
Example
curl -fsS https://grid-lab.zyxio.xyz/managed-services/instances \
-H "x-api-key: $BROWSERGRID_API_KEY"For an account with no instances:
{"schemaVersion": "managed-service-instance-list/v1", "instances": []}Billing
Free. Reading the list does not change active plan accrual.
See also
Managed services, POST /managed-services/instances, GET /managed-services/instances/{instanceId}.