Rate a response

Marks an individual respondent comment as helpful or not_helpful.

Calling this with rating: "helpful" records a positive vote.

Calling with rating: "not_helpful" flags the response as low-quality. For non-admin users this counts against a 10-flag-per-survey cap (returns 409 when exceeded). When the cap is not exceeded the response — and, on multi-question surveys, all responses from the same respondent — is automatically marked as rejected, the survey’s valid-answer count is recalculated, and a previously completed survey may be reopened to collect replacement responses.

The endpoint is upserting: re-rating the same response replaces the previous rating and preserves any existing comment when one is not re-supplied. Switching a previous not_helpful rating to helpful records the new vote but does NOT un-reject the answer that was auto-rejected by the prior flag.

Use DELETE /v1/responses/{id}/rate to remove a rating; note that DELETE does NOT un-reject an answer that was rejected by a prior not_helpful rating, and removing a flag does free up cap space — repeatedly flagging then deleting can reject more than 10 answers without tripping the cap.