TRACE_ASSET_FORBIDDEN
403invalid_requestThe asset key is malformed or outside the run prefix.
Cause
The requested key failed shape validation (traversal, control characters, URL-encoded separators) or points outside the run's own storage prefix.
How to fix it
Use a key exactly as returned in that run's asset manifest — asset keys are not composable by hand.
Example response
403 TRACE_ASSET_FORBIDDEN
JSON
{
"error_code": "TRACE_ASSET_FORBIDDEN",
"error_type": "invalid_request",
"error_message": "The asset key is malformed or outside the run prefix.",
"hint": "Use a key exactly as returned in that run's asset manifest — asset keys are not composable by hand.",
"docs_url": "https://docs.billerapi.com/errors/TRACE_ASSET_FORBIDDEN",
"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/TRACE_ASSET_FORBIDDEN
Was this page helpful?