AGENT_TRACE_NOT_FOUND
404invalid_requestNo agent trace for that run.
Cause
The (agent_type, run_id) pair does not resolve to a stored trace. Traces are written at run start and expire with the retention window.
How to fix it
Verify the agent_type and run_id. If the run has not started yet, poll rather than treating this as a permanent failure.
Example response
404 AGENT_TRACE_NOT_FOUND
JSON
{
"error_code": "AGENT_TRACE_NOT_FOUND",
"error_type": "invalid_request",
"error_message": "No agent trace for that run.",
"hint": "Verify the agent_type and run_id. If the run has not started yet, poll rather than treating this as a permanent failure.",
"docs_url": "https://docs.billerapi.com/errors/AGENT_TRACE_NOT_FOUND",
"request_id": "d94f5e2a-8c3b-4f1e-9a7d-6b2c1e0f8a34"
}Related
- Error handling — the error envelope shape and how to parse it
- Error code reference — every stable error code
Canonical docs URL: https://docs.billerapi.com/errors/AGENT_TRACE_NOT_FOUND
Was this page helpful?