List Suggestions
List entity suggestions for the workspace — proposed library changes generated from analytics (calls, emails, deals) and other sources. Mirrors the Suggestions inbox: defaults to pending suggestions from the last 14 days. Each item includes its change type (‘add’ = new entity, ‘refine’ = change to an existing one), the entity name, the description (add) or instruction message (refine), and the reasoning.
Authorizations
Query Parameters
Filter by status. Defaults to ['pending'] — the items awaiting review, matching the Suggestions inbox default.
draft, pending, accepted, rejected, dismissed, expired Filter by change type: 'add' (new entity) or 'refine' (change to an existing one). Omit to include both.
add, refine Filter by the library entity type being added or refined (e.g. Persona, Product, UseCase, Competitor). Omit to include all.
Product, Service, Solution, Persona, UseCase, Reference, Segment, Competitor, Alternative, BuyingTrigger, CoreFeature, Objection, ProofPoint, Playbook, Agent, Hypothesis, BrandVoice, Resource Look back this many days from now. Defaults to 14 (the inbox default). Ignored when startDate is provided.
x > 0Only include suggestions created on or after this date (ISO 8601). Overrides daysBack when set.
Only include suggestions created on or before this date (ISO 8601).
Restrict to suggestions originating from these sources (e.g. ANALYTICS, DIRECT_FINDINGS, USER_CREATED). Omit to include all sources.
analytics, brand_voice, user_created, ask_octave, ask_octave_manual, resource, crm_import, direct_findings, trends Max results to return (1-100, default 20).
0 < x <= 100Pagination offset (default 0).
x >= 0Sort by createdAt. Defaults to 'desc' (newest first).
asc, desc Response
List of entity suggestions for the workspace
Total suggestions matching the filters.
Status counts across the timeframe/filters, ignoring the status filter.
Offset for the next page, or null when there are no more results.