Skip to navigation
AgentRouter APIDisputes

Open a dispute

View as Markdown

For charged runs (at most 50, within 30 days) whose correct input returned wrong or unusable data. Describe the goal, what went wrong and, when possible, the find query and a comparison run. A reviewer decides; approved refunds go back to the wallet once.

Authentication

AuthorizationBearer
An AgentRouter API key or an OAuth access token issued to an MCP host or the CLI.

Request

This endpoint expects an object.
run_idslist of stringsRequired
goalstringRequired<=2000 characters
What the user was trying to get.
reasonstringRequired<=4000 characters
What was wrong or unusable.
find_querystringOptional
The find query that led to the tool.
comparison_run_idstringOptional
A run that shows the expected result.
evidencestringOptional<=8000 characters

Response

The dispute
dispute_idstring
statusenum
refund_statusenum
Allowed values:
run_idslist of strings
goalstring
reasonstring
refundslist of objects
decisionobject or null
historylist of objects
created_atstring
updated_atstring
find_querystring or nullOptional
comparison_run_idstring or nullOptional
evidencestring or nullOptional

Errors

400
Bad Request Error
404
Not Found Error
409
Conflict Error