POST /feedback

1 min read

Records a thumbs up or down on an answer. Use it when your chatbot asks customers whether an answer helped. The vote shows on the answer in Conversations, and a thumbs down puts the question on the Unanswered list. The website widget sends its Was this helpful? votes here.

POST https://answers.snoowl.com/api/v1/feedback
Authorization: Bearer ansk_…
Content-Type: application/json

Accepts a secret key, a website key or a preview key. Feedback isn’t rate-limited and isn’t charged.

Request

Field	Type	Required	Description
`answer_id`	string	Yes	The `answer_id` from POST /answer, or `snoowl.answer_id` from POST /chat/completions.
`helpful`	boolean	Yes	`true` for a thumbs up, `false` for a thumbs down. Must be a JSON boolean, not a string.
`note`	string	No	What the customer said, shown with the vote in Conversations. Up to 500 characters are kept.

Example

curl https://answers.snoowl.com/api/v1/feedback \
  -H "Authorization: Bearer YOUR_ENDPOINT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"answer_id": "3f2a9c1e5b7d40a8b1c2", "helpful": false, "note": "I asked about yearly plans."}'

await fetch("https://answers.snoowl.com/api/v1/feedback", {
  method: "POST",
  headers: { Authorization: "Bearer YOUR_ENDPOINT_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({ answer_id: "3f2a9c1e5b7d40a8b1c2", helpful: false, note: "I asked about yearly plans." }),
});

import requests

requests.post(
    "https://answers.snoowl.com/api/v1/feedback",
    headers={"Authorization": "Bearer YOUR_ENDPOINT_KEY"},
    json={"answer_id": "3f2a9c1e5b7d40a8b1c2", "helpful": False, "note": "I asked about yearly plans."},
)

Response

A 200 with an empty object:

{}

Sending feedback again for the same answer replaces the earlier vote and note.

Errors

Status	Why
`400`	`helpful` is missing or isn’t `true` or `false`
`401`	The key is missing, unknown or revoked
`403`	A website key used from a site that isn’t on its list
`404`	No answer with that ID for this key’s assistant. Answers from another assistant aren’t found, and neither are answers already deleted under the assistant’s Keep conversations for setting.

See the error format.