Skip to main content
POST
Rate a result

Authorizations

X-API-Key
string
header
required

Headers

Idempotency-Key
string

Any unique string up to 255 visible characters. Send the same key when you retry a request: for 12 hours a repeat returns the first answer again, with an Idempotent-Replayed: true header, without doing the work or charging a second time. A repeat that arrives while the first is still running gets 409 IDEMPOTENCY_IN_PROGRESS; the same key with a different body gets 409 IDEMPOTENCY_KEY_REUSED.

Maximum string length: 255
Example:

"3f2b8c1e-retry-safe-key"

Body

application/json
rating
enum<string>
required

Whether the result was accurate.

Available options:
good,
bad
requestId
string<uuid>

The request being rated: the X-Request-Id response header, or usage.requestId from an MCP tool. Give this or url.

url
string

The URL that was read, when the request id is not to hand. Rates the latest request for it in the last 24 hours.

reasons
enum<string>[]

What was wrong, for a bad rating.

Available options:
missing_content,
wrong_content,
blocked,
slow,
formatting,
other
note
string

More detail, in your own words.

Maximum string length: 500

Response

data
object
required