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), honored only when the organization's v2-topics-view flag is on; without it the parameter is ignored and v1 is served. Under v2-topics-cutover v2 is served regardless of this parameter (v1 cannot be requested back). Omitted or 'v1' otherwise serves v1.
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. 'groups' sorts by the number of groups. Use 'similarity' with 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 product IDs (OR logic: topic must have messages in a channel mapped to ANY listed product). Pass "none" to also match topics with no product attribution at all.
Exclude topics by product IDs (OR logic: topic must have NO messages in a channel mapped to ANY listed product). Pass "none" to exclude topics with no product attribution at all.
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