curl http://localhost:4700/api/v1/agents/aG5kR8sLp3WvX1nC7qZtB \
-H "x-api-key: agtx_local_0f3c9a17d2b84e6a5c01b9f4e7d8a2c6431b5f97a0e2d4c8"
{
"agent": {
"_id": "aG5kR8sLp3WvX1nC7qZtB",
"name": "customer-support-agent",
"createdAt": "2026-08-27T10:30:00.000Z"
}
}
{
"error": "Agent not found"
}
Agent Registry
Get Agent
Fetch a single registered agent by id
GET
/
api
/
v1
/
agents
/
{id}
curl http://localhost:4700/api/v1/agents/aG5kR8sLp3WvX1nC7qZtB \
-H "x-api-key: agtx_local_0f3c9a17d2b84e6a5c01b9f4e7d8a2c6431b5f97a0e2d4c8"
{
"agent": {
"_id": "aG5kR8sLp3WvX1nC7qZtB",
"name": "customer-support-agent",
"createdAt": "2026-08-27T10:30:00.000Z"
}
}
{
"error": "Agent not found"
}
Returns one agent from the project’s registry. Use it to resolve an id you stored earlier (for
example, from Register Agent or a monitoring signal’s
agentId) back to its display name.
Agents cannot be deleted through the API - the registry row is the identity every trace,
monitoring profile, and signal for that agent keys off. The hosted platform’s
DELETE /ingest/tracked-agents/:botId endpoint does not exist on the self-host engine; to
quiet an agent, disable its monitoring profile instead
(PUT /api/v1/monitor/profiles/{agentId} with { "enabled": false }).Authentication
string
required
Project API key.
Path Parameters
string
required
Agent
_id from List Agents.Response
object
The agent:
{ "_id": string, "name": string, "createdAt": string }.Errors
| Status | Body | Meaning |
|---|---|---|
404 | { "error": "Agent not found" } | No agent with this id in the project |
curl http://localhost:4700/api/v1/agents/aG5kR8sLp3WvX1nC7qZtB \
-H "x-api-key: agtx_local_0f3c9a17d2b84e6a5c01b9f4e7d8a2c6431b5f97a0e2d4c8"
{
"agent": {
"_id": "aG5kR8sLp3WvX1nC7qZtB",
"name": "customer-support-agent",
"createdAt": "2026-08-27T10:30:00.000Z"
}
}
{
"error": "Agent not found"
}