Skip to main content
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.

Authorizations

Authorizationstringheaderrequired

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

Path Parameters

idstringrequired

Post unique identifier

Example: 507f1f77bcf86cd799439011

Query Parameters

cursorstringquery

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

Required string length: 1 - 512
Example: eyJkIjoiMjAyNi0wOS0yMVQwOTowMDowMC4wMDBaIiwiaSI6IjUwN2YxZjc3YmNmODZjZDc5OTQzOTAxMSJ9
limitintegerquery

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

Required range: 1 <= x <= 100
Example: 100

Headers

Featurebase-Versionenum<string>header

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

Available options: 2026-08-19.orbit, 2026-01-01.nova, 2025-12-12.clover
Example: 2026-08-19.orbit

Response

application/json

Success

dataobject[]required

Array of posts

nextCursorstring | nullrequired

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

Maximum string length: 512
Example: eyJpZCI6IjUwN2YxZjc3YmNmODZjZDc5OTQzOTAxMSJ9
objectenum<string>required

Object type identifier

Available options: list
Example: list
paginationobject

Pagination metadata for page-based requests

Still need help? Ask the team