> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sequenzy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Send Account Health Feedback

> Say whether a finding was useful

Tell the Sequenzy team whether a finding from [Get Account Health](./get) was useful to you. Your answer helps improve the suggestions and changes nothing in your workspace. To hide a finding, use [Update Account Health Insight](./update-insight).

* Each person has one answer per finding. The answer belongs to the API key's owner, so anyone answering with that key replaces the owner's own answer, including one given in the dashboard.
* Sending again replaces the rating. The earlier comment stays unless you send `comment`; `null` or an empty string clears it.
* You can answer for a finding in any status, including dismissed and resolved ones.
* Your answer shows as `feedback` on that finding in [Get Account Health](./get).

Requires the `analytics:read` scope, so viewers can answer too.

## Request

```bash theme={null}
curl -X POST "https://api.sequenzy.com/api/v1/account-health/insights/ins_123/feedback" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "rating": "not_useful", "comment": "We already send this from Stripe." }'
```

## Path

<ParamField path="insightId" type="string" required>
  The insight ID.
</ParamField>

## Body

<ParamField body="rating" type="string" required>
  `useful` or `not_useful`.
</ParamField>

<ParamField body="comment" type="string | null">
  What made it useful or not, up to 2,000 characters after trimming. Omit to keep an earlier comment; `null` or an empty string clears it.
</ParamField>

Other fields are rejected with a 400.

## Response fields

<ResponseField name="insightId" type="string">
  The insight you rated.
</ResponseField>

<ResponseField name="feedback" type="object">
  Your saved answer.

  <Expandable title="properties">
    <ResponseField name="rating" type="string">
      `useful` or `not_useful`.
    </ResponseField>

    <ResponseField name="comment" type="string | null">
      Your comment, or `null`.
    </ResponseField>

    <ResponseField name="updatedAt" type="string">
      When the answer last changed. Sending the same answer again does not change it.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "insightId": "ins_123",
    "feedback": {
      "rating": "not_useful",
      "comment": "We already send this from Stripe.",
      "updatedAt": "2026-10-15T10:00:00.000Z"
    }
  }
  ```

  ```json 400 theme={null}
  {
    "error": "rating must be one of: useful, not_useful."
  }
  ```

  ```json 403 theme={null}
  {
    "error": "API key is missing required scope: analytics:read"
  }
  ```

  ```json 404 theme={null}
  {
    "error": "Insight not found"
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.