Start, stop, or restart a hosted agent

POST

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

POST

/v1/hosted-agents/instances/:instance_id/:action

$ curl -X POST https://api.empiriolabs.ai/v1/hosted-agents/instances/instance_id/start \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{}'

200Successful

1 {
2   "instance": {
3     "id": "a3f47c2e-9b1d-4f3a-8c2e-7d9f4b6a1e2c",
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/a3f47c2e-9b1d-4f3a-8c2e-7d9f4b6a1e2c",
11     "api_base_path": "/agents/a3f47c2e-9b1d-4f3a-8c2e-7d9f4b6a1e2c/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": 1240
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

actionenumRequired

Allowed values:

Response

Action applied.

instanceobjectOptional