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 per-survey flag cap. Free (pay-as-you-go) survey owners may flag up to 10% of the sample size (rounded up); subscribed (PickFu+/Enterprise) owners have no cap. Returns 409 when the cap is 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 answers than the cap allows without tripping it.