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 = "ToolValidation"

​
When this error occurs

The model produced arguments that didn’t satisfy the tool’s input schema:
  • Required field missing.
  • Field type didn’t match (string expected, integer given).
  • additionalProperties: false rejected an extra key.
Either the local pre-flight check caught it (using the schema in mcp_servers[].tools[].input_schema), or the MCP server itself rejected with JSON-RPC -32602.

​
How to fix

  • Improve the input_schema in the run’s config to be tighter — required fields, strict enums, additionalProperties: false. Tighter schemas → fewer model mistakes.
  • Strengthen the tool description with a concrete example so the model copies the shape.
  • This error is not retried by the workflow; the activity tag is in RetryOptions.setDoNotRetry. The run fails fast and the caller can re-prompt.