Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.narrative.io/llms.txt

Use this file to discover all available pages before exploring further.

Surface: GET /agents/runs/{id}, error.type = "AgentLoopInvalidRequestPayload"

​
When this error occurs

The workflow’s load activity reads agent_runs.request_payload and expects one of:
  • {"kind": "user_message", "text": "..."}
  • {"kind": "tool_outputs", "outputs": [...]}
This error means the JSONB doesn’t carry a recognised kind value or fails to decode the body for the recognised kind. Most commonly: a payload that bypassed the API and was hand-inserted into the database with an unexpected shape, or a future API version emitting a kind value the workers don’t recognise yet.

​
How to fix

If the row was created through the API, this is a server-side schema-drift bug — file an issue with the log_id and the run id. If the row was hand-seeded (e.g. via the AgentLoopStarter test harness), check the payload JSON against the RunRequestPayload shape.