Alpha APIKnowledge

List Findings

View as Markdown

Paginated findings inventory. Filters: type, source, meetingId (only entities from that meeting). sort: ‘mentions’ (default) or ‘recent’ (by lastMentionedAt). compact=true returns only {id, name, type, mentionCount, lastMentionedAt}. recommended for orientation; fetch details with get_entity. Returns {findings, total, nextCursor}.

Authentication

AuthorizationBearer
Create a personal key in Alpha settings, or use an access token issued to an approved OAuth client.

Request

This endpoint expects an object.
vaultstringOptional

Exact vault id or name from list_vaults. Required whenever the key can reach more than one vault; never guess or use one client’s vault for another.

typeenumOptional
sourceenumOptional
Allowed values:
meetingIdstringOptional
Only entities with evidence from this meeting
sortenumOptional
Allowed values:
limitdoubleOptional

Page size (default 50, max 200)

cursorstringOptional
nextCursor from the previous page
compactbooleanOptional

Slim payload (default false)

Response headers

X-Request-IdstringOptional
Stable identifier for tracing this request in Alpha logs.

Response

List Findings completed.
datamap from strings to any or list of maps from strings to any
The result returned by the selected Alpha tool.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error