NOT_GROUPED — Question grouping required

Summary

Some operations — wave-over-wave comparisons, grouped exports, tracker-style refinements — require questions to be grouped (typically into survey waves). The question you referenced isn’t part of any group.

HTTP status

409 Conflict. Standard envelope.

Example response

{
  "success": false,
  "error": {
    "code": "NOT_GROUPED",
    "message": "Question q_01HXJZK... is not part of a group. Group it first via POST /v1/projects/{id}/groups.",
    "request_id": "req_01HXJZK4ABCDEF",
    "doc_url": "https://docs.surveycoder.io/errors/not-grouped"
  }
}

Why this happens

You’re running a tracker-style endpoint on a one-off question.
You created a new wave but forgot to attach it to the existing group.
A group was deleted but the question reference wasn’t updated.

How to fix it

Create a group: POST /v1/projects/{id}/groups with a name like Brand tracker — laundry.
Add the question(s): POST /v1/projects/{id}/groups/{gid}/members with the question IDs.
Retry the original operation.
For one-off questions that genuinely don’t need a group, use the non-grouped variant of the endpoint (most endpoints have both forms — see the API reference).