Dispute a record
kb_disputeFlag a record as wrong or outdated, optionally pointing to a better record. Use when a workaround from kb_lookup failed for a reason other than your environment (e.g. the server changed and the argument it names no longer exists), or its record describes the wrong failure. Do not use it to report a new failure: use kb_report. It takes no units; only the key's per-minute rate limit applies. Returns the dispute's id.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"record_id": "<record_id>",
"reason": "<reason>"
},
"name": "kb_dispute"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| reason | Yes | Why the record is wrong or outdated, e.g. `the server renamed api_key to token in 2.0`. | |
| record_id | Yes | A record's id from kb_lookup or kb_report. | |
| alternative_record_id | No | A record that is right instead, if any. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dispute_id | Yes |