Skip to content
Documentation/Verification

Record review feedback

Record whether a reviewer accepts, rejects, or is unsure about a batch result.

Markdown
POST/api/v1/verify/feedbackhttps://api.webcite.co

When to use it

Pass the feedback_token from a batch result as token. Valid verdicts are correct, incorrect, and unsure. Feedback records a review; it is not a promise that the underlying source or model has been changed.

Request

1 credit.

Examples run on your server. Set WEBCITE_API_KEY first. Python examples use the requests package.

curl
curl --fail-with-body -X POST 'https://api.webcite.co/api/v1/verify/feedback' \
  -H "x-api-key: $WEBCITE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "token": "FEEDBACK_TOKEN_FROM_BATCH",
  "verdict": "incorrect",
  "note": "The quotation omits the stated reporting period."
}'

Request body

notestring

Optional note or correction.

tokenstringrequired

The feedback_token from a batch result.

verdictstringrequired

The human verdict on the result.

Values: "correct""incorrect""unsure"

Response

Returns confirmation that the feedback was recorded. The public schema does not define every response field.

200 response

See the response guidance above. A complete JSON schema is not published for this response.

Errors

For 400, check the request fields and source identifiers. For 401, check your API key. For 429, wait for the retry interval. See the errors guide before retrying a billable request.

400
Invalid feedback_token
401
Unauthorized - API key required
429
Rate limit exceeded
Error handling and retry guidance