AGENT_TRACE_INVALID
400invalid_requestThe agent trace payload is invalid.
Cause
The AgentTrace aggregate refused the fields: an unsupported outcome, a missing agent_type/run_id, or a malformed usage block.
How to fix it
Fix the offending field named in error_message and resend. This is deterministic — a retry of the same payload fails identically.
Example response
400 AGENT_TRACE_INVALID
JSON
{
"error_code": "AGENT_TRACE_INVALID",
"error_type": "invalid_request",
"error_message": "The agent trace payload is invalid.",
"hint": "Fix the offending field named in error_message and resend. This is deterministic — a retry of the same payload fails identically.",
"docs_url": "https://docs.billerapi.com/errors/AGENT_TRACE_INVALID",
"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_INVALID
Was this page helpful?