Get a hosted agent

GET

https://api.empiriolabs.ai/v1/hosted-agents/instances/:instance_id

GET

/v1/hosted-agents/instances/:instance_id

$ curl https://api.empiriolabs.ai/v1/hosted-agents/instances/instance_id \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json"

1 {
2   "instance": {
3     "id": "a3f47c9e-8b2d-4f1a-9c3e-2d5b7f6a1e4c",
4     "agent_type": "openclaw",
5     "name": "Customer Support Bot",
6     "plan_slug": "pro-monthly",
7     "status": "running",
8     "default_provider": "empirio",
9     "billing_status": "active",
10     "connect_path": "/agents/a3f47c9e-8b2d-4f1a-9c3e-2d5b7f6a1e4c",
11     "api_base_path": "/agents/a3f47c9e-8b2d-4f1a-9c3e-2d5b7f6a1e4c/v1",
12     "replica_min": 2,
13     "replica_max": 5,
14     "replica_current": 3,
15     "next_billing_at": "2024-07-01T00:00:00Z",
16     "billed_amount": 45.75,
17     "messages_used_current_period": 12450
18   }
19 }

Authentication

AuthorizationBearer

Pass your EmpirioLabs API key as a bearer token. The Anthropic-style x-api-key header is also accepted on every endpoint.

Path parameters

instance_idstringRequired

Response

Hosted agent detail.

instanceobjectOptional

Errors

404

Not Found Error