---
title: "Summarize survey responses"
method: GET
path: "/engagement/surveys/{surveyId}/responses/summarize"
tags: ["Engagement Survey"]
---

# Summarize survey responses

`GET /engagement/surveys/{surveyId}/responses/summarize`

AI summary of a survey's responses. Returns `status` `ok` with `summary` (plain text) and `data` (headline,
overview, sentiment, findings with verbatim quotes that carry the response `ticketId`, themes, actions),
`not-enough-data` below 3 responses, `rate-limited` within 60 seconds of the last attempt, or `failed`
shortly after a failed attempt. A stored summary is returned without calling the model; `refresh=true`
regenerates it (at most once per minute). `outdated` is true when responses arrived after it was generated.
Uses up to the 999 newest responses within a 30,000-token budget. Consumes AI credits; 402 when the
organisation is out of AI usage, 409 when generation fails and nothing is stored.

## Path parameters

- `surveyId` string, required

## Query parameters

- `refresh` boolean

## Headers

- `project` string, required

## Response `200`

Ok

- unknown

## Changes

- **2026-09-18** `55f99ebe7b16` — 1 info
  - added the new optional `query` request parameter `refresh`

[Change history](https://skmtc.dev/gleap/apis/gleap-server/changes/engagement/surveys/:surveyId/responses/summarize/get.md)

---

[API](https://skmtc.dev/gleap/apis/gleap-server.md) · [All operations](https://skmtc.dev/gleap/apis/gleap-server/llms.txt) · [OpenAPI document](https://skmtc.dev/gleap/apis/gleap-server/revisions/0a92e15c9803?raw)