Feedback

Records whether a result was good. request_id is the id of the request you are rating, as a UUID (the part of an X-Request-ID header after req_); feedback is thumbs_up or thumbs_down; feedback_text is an optional comment of at most 4096 characters. You can rate only a request your own account made: an id that was never issued, or that belongs to another account, is 404 not_found (the record of a request is written just after its answer is sent, so rate it a moment later, not in the same instant). Sending the same rating twice stores it twice.

Every problem with the body, including text that is not valid JSON, is 400 invalid_request; the message names the field. Only an over-long comment has its own code, feedback_text_too_long. If the rating could not be stored the reply is 503 db_unavailable; send it again.

curl -X POST "https://api.scarleta.ai/v1/feedback" \
  -H "Authorization: Bearer $SCARLETA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "request_id": "4e1b7c9a-2d58-4f03-8a6b-5c0d9e1f2a37",
    "feedback": "thumbs_up",
    "feedback_text": "Great result"
  }'

{
  "data": {
    "success": true,
    "request_id": "4e1b7c9a-2d58-4f03-8a6b-5c0d9e1f2a37",
    "feedback": "thumbs_up",
    "message": "✓ Feedback recorded: thumbs_up - Great result"
  },
  "meta": {
    "request_id": "req_0b7a3c2e-6f1d-4d9a-8e55-3a4b5c6d7e8f"
  }
}