Ir al contenido principal
Posts

List the insights filed under a request

Returns the insights filed under the request {id} — the customer quotes kept as evidence for it. Newest first.

GET
/v2/posts/{id}/insights

Posts linked with attachTo are not listed here: they are posts, not insights, and they stay in GET /v2/posts. This endpoint lists exactly the rows that POST /v2/posts/{insightId}/link-insight filed under this request.

Query parameters

  • limit — insights per page, 1–100. Defaults to 100, so most requests return their whole evidence set in one call.
  • cursor — opaque cursor from a previous response's nextCursor.

Response format

The standard post list envelope:

  • object — always "list"
  • data — the insights, each in the same shape as any other post object, with kind: 'insight' and linkedIssueId set to {id}
  • nextCursor — pass it back as cursor for the next page; null on the last page

pagination is never returned by this endpoint — it is cursor-paginated only.

Notes

  • Pass the request's id, not an insight's. An id that is not a request (an insight, or an unknown id in this workspace) is not an error: the list simply comes back empty.
  • The insights returned are not readable through GET /v2/posts/{insightId} — that endpoint serves work items only.
Authorizationstringheaderobligatorio

API key as Bearer token. Use: Authorization: Bearer sk_...

idstringobligatorio

Post unique identifier

Ejemplo: 507f1f77bcf86cd799439011
cursorstringquery

Opaque cursor from a previous page's nextCursor. Omit for the first page.

Required string length: 1 - 512
Ejemplo: eyJkIjoiMjAyNi0wOS0yMVQwOTowMDowMC4wMDBaIiwiaSI6IjUwN2YxZjc3YmNmODZjZDc5OTQzOTAxMSJ9
limitintegerquery

Insights per page, 1–100. Defaults to 100 — the whole evidence set of most requests comes back in one call.

Rango requerido: 1 <= x <= 100
Ejemplo: 100
Featurebase-Versionenum<string>header

API version for this request. Defaults to your organization's configured API version if not specified.

Opciones disponibles: 2026-08-19.orbit, 2026-01-01.nova, 2025-12-12.clover
Ejemplo: 2026-08-19.orbit

Respuesta

application/json

Success

dataobject[]obligatorio

Array of posts

nextCursorstring | nullobligatorio

Cursor for fetching the next page (cursor-based pagination)

Maximum string length: 512
Ejemplo: eyJpZCI6IjUwN2YxZjc3YmNmODZjZDc5OTQzOTAxMSJ9
objectenum<string>obligatorio

Object type identifier

Opciones disponibles: list
Ejemplo: list
paginationobject

Pagination metadata for page-based requests