List topics
List topics (issues) with filters, message counts, and authors. When embeddingSearch is provided, performs semantic search using vector similarity instead of keyword search. Semantic search finds topics by meaning, useful for queries like “users having trouble with authentication”.
Authorizations
Organization API key (modem_…).
Query Parameters
Topics source pipeline. 'v2' serves rows from the v2 ingest pipeline (v2_topics) and is only honored when the organization's v2-topics-view feature flag is on — without the flag the parameter is ignored and v1 is served. Omitted or 'v1' always serves the v1 pipeline.
v1, v2 Keyword search on title (max 100 chars). Wrap in double-quotes for exact token matching (e.g. "persona" matches the whole word and excludes "personal"). Ignored if embeddingSearch is provided.
100Semantic search query using vector similarity. When provided, finds topics by meaning instead of keywords. Overrides the search parameter.
1 - 1000Minimum cosine similarity threshold for embeddingSearch (0-1, higher = more similar). Default 0.7.
0 <= x <= 1Filter topics by keywords/categories (OR logic: topic must have ANY of the listed categories). Case-insensitive.
Exclude topics by keywords/categories (OR logic: topic must have NONE of the listed categories). Case-insensitive.
bug_report, complaint, discussion, feature_request, praise bug_report, complaint, discussion, feature_request, praise Filter topics by message sources (OR logic: topic must have messages from ANY listed source). Case-insensitive; duplicates are ignored.
1Exclude topics by message sources (OR logic: topic must have NO messages from ANY listed source). Case-insensitive; duplicates are ignored.
1Filter topics by time range overlap
Sort order. Use 'similarity' when using embeddingSearch for best results.
date, groups, lifecycle, priority, similarity asc, desc Priority level: very_low, low, default, high, or very_high
default, high, low, very_high, very_low Priority level: very_low, low, default, high, or very_high
default, high, low, very_high, very_low Filter topics by lifecycle state. "unknown" also matches topics with no lifecycle assessment.
LLM-assessed lifecycle state for a topic.
completed, dismissed, in_progress, open, unknown Filter topics by company IDs (OR logic: topic must have messages from people associated with ANY listed company).
Exclude topics by company IDs (OR logic: topic must have NO messages from people associated with ANY listed company).
Filter topics by person IDs (OR logic: topic must have messages from ANY listed person).
Exclude topics by person IDs (OR logic: topic must have messages from NONE of the listed people).
Filter by linked ticket presence. "has_ticket" = has any linked ticket, "none" = no linked ticket.
has_ticket, none Exclude by linked ticket presence. "has_ticket" excludes topics with tickets, "none" excludes topics without tickets.
has_ticket, none Filter by team response status. "not_responded" = no team member replied, "fully_responded" = team replied in all groups, "partially_responded" = team replied in some groups.
fully_responded, not_responded, partially_responded x <= 100