When to report
Report an answer that is wrong or incomplete, or a search that missed what you needed. Send one rating for each call, with the call’srequestId as jobId. Do not report errors you can fix by changing the request.
Make a request
This request rates a search as good.jobId is the requestId from the search answer.
Read the response
feedbackId names your report. refundedUsd is what this rating gave back, and refundedTodayUsd is what has been refunded today out of dailyRefundCapUsd. dailyCapReached is true once the cap is used.
Rating the same jobId again returns the first feedbackId with alreadySubmitted: true and refunds nothing.
Rate a search
POST /v1/search/{jobId}/feedback rates a search and takes the search’s requestId in the path. Use it to say which results helped and what was missing.
alreadySubmitted: false.
Options
Both calls take these fields.rating is required.
POST /v1/feedback also takes these:
Refunds
Abad rating refunds what the rated call cost, back into your balance. The refunds add up to at most $0.10 a day. After that the rating is still saved and dailyCapReached is true. A call that cost nothing, or one that was not billed to your account, has nothing to refund. Each call can be rated once.
Limits and errors
Tell your agent
Add a line like this to your agent’s instructions file, such asAGENTS.md or CLAUDE.md.