CotalList managed console agents
Return the manager-owned seats with process status, incarnation coordinates and available presence observations. mesh is a verdict only when meshView is current and the observed identity matches the managed seat. Optional facts are absent when not recorded.
AuthorizationBearer <token>Per-manager console token.
Current managed seats.
application/json- response
[index: integer]?curl -X GET 'http://127.0.0.1:12345/agents'[ { "name": "string", "id": "string", "role": "string", "agent": "string", "space": "string", "mode": "string", "status": "string", "mesh": "string", "meshView": "string", "lifecycleUid": "string", "model": "string", "variant": "string", "provider": "string", "cwd": "string", "spawner": "string", "instanceId": "string", "host": "string", "authHealth": "string", "authReason": "string", "uptimeMs": 0, "pid": 0, "activeAt": 0, "presenceIdentityVerified": true, "presenceObservedAt": 0, "offlineSince": 0, "condition": { "code": "string", "source": "string", "message": "string", "since": 0 }, "joinHealth": { "state": "degraded", "reason": "string" }, "resume": {} }]See the HTTP interface overview for authentication and access requirements.
Complete HTTP contract
Endpoint
GET /agentsReturn the manager-owned seats with process status, incarnation coordinates and available presence observations. mesh is a verdict only when meshView is current and the observed identity matches the managed seat. Optional facts are absent when not recorded.
Parameters
No operation parameters.
Responses
HTTP 200
Current managed seats.
Content type: application/json.
{
"type": "array",
"items": {
"$ref": "#/components/schemas/ManagedAgent"
}
}HTTP 401
The manager console token is missing or invalid.
Content type: text/plain.
{
"type": "string"
}HTTP 500
Unexpected request failure.
Content type: text/plain.
{
"type": "string"
}Authentication and access: Operator HTTP interface of the reference manager console. This is separate from the Dashboard HTTP API. The default bind is 127.0.0.1 on an allocated port; an operator can configure the bind host and port. Every data operation requires the per-manager console token, even on loopback. Supply a bearer header or query parameter t. If both are present, t takes precedence. The launch page keeps its token in the URL fragment.
Read routes also accept other bodyless methods; only the documented GET behavior is promised. Query strings are removed for route dispatch. Session establishment mints credentials for a broker WebSocket connection; the console does not expose a WebSocket terminal endpoint. Static HTML, scripts, styles and favicon resources are outside this API reference.
OpenAPI specification contains the referenced response schemas. Complete Markdown reference.