API Reference
Get Agent
GET /api/v1/agents/:agentId — fetch a single agent by ID.
Returns the full detail of one agent.
GET /api/v1/agents/{agentId}Path parameters
Response
200 OK
{
"agentId": "3f9c1a2e-...",
"name": "Support Bot",
"description": "Handles Tier 1 support tickets",
"status": "active",
"projectId": null,
"config": { "...": "full agent config object" },
"configSchemaVersion": 1,
"createdAt": "2026-06-01T12:00:00.000Z",
"updatedAt": "2026-06-15T09:30:00.000Z"
}Errors
| Status | error | When |
|---|---|---|
403 | forbidden | The agent exists but belongs to a different project than your project-scoped key |
404 | agent_not_found | No agent with that ID exists in your organization |
Example
curl https://api.elizon.com/api/v1/agents/3f9c1a2e-... \
-H "X-API-Key: elz_your_key_here"