For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.

List saved Agent Analytics insights

Returns saved cost, efficiency, and quality findings, ranked by magnitude
times confidence. These are periodically evaluated findings, not live
queries. Healthy and closed findings can remain visible. Thumbs-downed
findings are excluded. Use each finding's project_id for individual reads.

get/v1/projects/{project_id}/agent-analytics/insights

Authorizations

Authorizationstringrequired

http

Path parameters

project_idstringrequired

Amplitude project identifier, backed by the canonical app ID.

Example:12345
Constraints:pattern: ^[0-9]+$

Query parameters

limitinteger

Number of items to return. Defaults to 50, max 200.

Default:50
Constraints:min: 1max: 200
cursorstring

Opaque cursor from pagination.next_cursor on the previous response. Numeric offsets are capped by the underlying search index (10,000 results per query). Well-formed pagination stops before that window; requests whose cursor would exceed it return 400 pagination_not_supported.

Constraints:nullable
agent_namestring

Exact agent name. Omit for all scopes; an empty string selects project-level findings only.

Response

application/json
200· Saved findings and an opaque next-page cursor. Keep the same project and agent filter when paging.
dataobject[]required
Show child attributes
idstringrequired
Constraints:format: uuid
objectstringrequired
project_idstringrequired

The finding's own project, including when listed through a portfolio.

agent_namestringrequired

Empty for project-level findings.

finding_keystringrequired

Rule key, such as tool-failures. Not a unique finding identifier.

categorystringrequired
Allowed values:costefficiencyquality
titlestringrequired
summarystringrequired
recommendationstringrequired
measurementsobject[]required
keystringrequired
labelstringrequired
valuenumberrequired
unitstringrequired
Constraints:nullable
evidenceobjectrequired
session_idsstring[]required
chart_definitionobjectrequired

Opaque, read-only chart definition. Its nested keys are preserved; the shape is not intended for authoring.

Constraints:nullable
magnitudenumberrequired
Constraints:min: 0max: 1
confidencenumberrequired
Constraints:min: 0max: 1
scorenumberrequired

100 times magnitude times confidence; higher ranks first.

Constraints:min: 0max: 100
statusstringrequired
Allowed values:openedin_progressclosed
window_startstringrequired
Constraints:format: date-time
window_endstringrequired
Constraints:format: date-time
evaluated_atstringrequired
Constraints:format: date-time
paginationobjectrequired
Show child attributes
next_cursorstringrequired

Cursor for the next page, or null on the last page. Chart list responses may stop before all project charts are enumerated because the search backend caps each query at 10,000 sorted hits.

Constraints:nullable
has_morebooleanrequired

Was this helpful?