# Record review feedback

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

Documentation index: https://webcite.co/llms.txt
Canonical page: https://webcite.co/api-docs/feedback
API origin: https://api.webcite.co
Authentication: x-api-key header. Keep keys on your server.

## 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

POST /api/v1/verify/feedback

1 credit.

### curl

```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."
}'
```

### Node.js

```javascript
const response = await fetch("https://api.webcite.co/api/v1/verify/feedback", {
  method: "POST",
  headers: {
    "x-api-key": process.env.WEBCITE_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "token": "FEEDBACK_TOKEN_FROM_BATCH",
  "verdict": "incorrect",
  "note": "The quotation omits the stated reporting period."
}),
});
if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`);
console.log(await response.json());
```

### python

```python
import os
import json
import requests

payload = json.loads("{\n  \"token\": \"FEEDBACK_TOKEN_FROM_BATCH\",\n  \"verdict\": \"incorrect\",\n  \"note\": \"The quotation omits the stated reporting period.\"\n}")
response = requests.post(
    "https://api.webcite.co/api/v1/verify/feedback",
    headers={"x-api-key": os.environ["WEBCITE_API_KEY"]},
    json=payload,
    timeout=(10, 300),
)
response.raise_for_status()
print(response.json())
```

## Response

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

## 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.

## OpenAPI operation

```json
{
  "path": "/api/v1/verify/feedback",
  "method": "POST",
  "operation": {
    "description": "Accept, reject, or flag a result using the feedback_token from a batch result. The token carries the result summary, so token plus verdict is enough. Feedback is stored so corrections accumulate over time.\n\n**Cost: 1 credit.** No LLM calls; records a single row. Subject to your plan's rate limits.",
    "operationId": "ApiV1Controller_verifyFeedback",
    "parameters": [],
    "requestBody": {
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/VerifyFeedbackRequestDto"
          }
        }
      },
      "required": true
    },
    "responses": {
      "200": {
        "description": "Feedback recorded"
      },
      "400": {
        "description": "Invalid feedback_token"
      },
      "401": {
        "description": "Unauthorized - API key required"
      },
      "429": {
        "description": "Rate limit exceeded"
      }
    },
    "security": [
      {
        "x-api-key": []
      },
      {
        "bearer": []
      }
    ],
    "summary": "Record a verdict on a verification result",
    "tags": [
      "Public API"
    ]
  },
  "schemas": {
    "VerifyFeedbackRequestDto": {
      "properties": {
        "note": {
          "description": "Optional note or correction.",
          "type": "string"
        },
        "token": {
          "description": "The feedback_token from a batch result.",
          "type": "string"
        },
        "verdict": {
          "description": "The human verdict on the result.",
          "enum": [
            "correct",
            "incorrect",
            "unsure"
          ],
          "type": "string"
        }
      },
      "required": [
        "token",
        "verdict"
      ],
      "type": "object"
    }
  }
}
```