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

# Review saved responses (POST form)

> Review saved responses (POST form)

### Request body

`ReviewRequest`

<ParamField body="orgId" type="string" required />

<ParamField body="agentId" type="string" required />

<ParamField body="limit" type="number" />

<ParamField body="includeRecords" type="boolean">
  Per-response scores and signals, for debugging
</ParamField>

### Response

`ReviewResponse`

<ResponseField name="ok" type="boolean" />

<ResponseField name="generatedAt" type="string (date-time)" />

<ResponseField name="orgId" type="string" />

<ResponseField name="agentId" type="string" />

<ResponseField name="limit" type="number" />

<ResponseField name="analysis" type="object">
  The endpoint does not change rules or examples; promote approved drafts yourself.

  <Expandable title="analysis">
    <ResponseField name="summary" type="object">
      <Expandable title="summary">
        <ResponseField name="total" type="number" />

        <ResponseField name="working" type="number" />

        <ResponseField name="watch" type="number" />

        <ResponseField name="needsImprovement" type="number" />

        <ResponseField name="averageScore" type="number" />
      </Expandable>
    </ResponseField>

    <ResponseField name="intents" type="object[]">
      <Expandable title="intents">
        <ResponseField name="intent" type="string" />

        <ResponseField name="total" type="number" />

        <ResponseField name="averageScore" type="number" />
      </Expandable>
    </ResponseField>

    <ResponseField name="suggestions" type="object[]">
      <Expandable title="suggestions">
        <ResponseField name="intent" type="string" />

        <ResponseField name="issue" type="string" />

        <ResponseField name="recommendation" type="string" />

        <ResponseField name="ruleDraft" type="object" />

        <ResponseField name="exampleDrafts" type="object[]" />
      </Expandable>
    </ResponseField>

    <ResponseField name="workingExamples" type="object[]">
      <Expandable title="workingExamples">
        <ResponseField name="customerMessage" type="string" />

        <ResponseField name="agentResponse" type="string" />
      </Expandable>
    </ResponseField>

    <ResponseField name="regressionCases" type="object[]">
      <Expandable title="regressionCases">
        <ResponseField name="message" type="string" />

        <ResponseField name="expectedBehavior" type="string" />
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

### Status codes

| Code  | Meaning |
| ----- | ------- |
| `200` | OK      |
| `400` | Error   |
| `401` | Error   |

<RequestExample>
  ```bash cURL theme={null}
  curl --request POST \
    --url 'https://api.example.com/api/response/review' \
    --header 'x-widget-token: YOUR_API_KEY' \
    --header 'Content-Type: application/json' \
    --data '{
    "orgId": "string",
    "agentId": "string",
    "limit": 20,
    "includeRecords": true
  }'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "ok": true,
    "generatedAt": "2026-08-31T14:22:05Z",
    "orgId": "string",
    "agentId": "string",
    "limit": 20,
    "analysis": {
      "summary": {
        "total": 102.12,
        "working": 1.5,
        "watch": 1.5,
        "needsImprovement": 1.5,
        "averageScore": 7.5
      },
      "intents": [
        {
          "intent": null,
          "total": null,
          "averageScore": null
        }
      ],
      "suggestions": [
        {
          "intent": null,
          "issue": null,
          "recommendation": null,
          "ruleDraft": null,
          "exampleDrafts": null
        }
      ],
      "workingExamples": [
        {
          "customerMessage": null,
          "agentResponse": null
        }
      ],
      "regressionCases": [
        {
          "message": null,
          "expectedBehavior": null
        }
      ]
    }
  }
  ```
</ResponseExample>