Skip to content
Skip to Content
Coder Docs

Conversation search syntax

Filter Coder Agents conversations by title, status, and linked pull requests with search syntax.

On this page

The chat list endpoint accepts a q query parameter for filtering conversations. All filters use key:value syntax. Bare search terms are rejected. Use title: for title filtering or search: for full-text search.

Filters

KeyValuesDescription
titlesubstringCase-insensitive substring match. Quote multi-word values.
archivedtrue, falseFilter by archived state. Default: false.
has_unreadtrue, falseConversations with unread assistant messages.
statuswaiting, running, error, requires_action, interruptingConversation state. Comma-separated or repeated values match any of them.
pr_statusdraft, open, merged, closed, noneLinked pull request state. Comma-separated for OR. none matches conversations with no linked pull request.
diff_urlURLMatch by associated diff URL. Quote values containing colons.
prpositive integerExact PR number match.
reposubstringCase-insensitive substring match against git remote origin or URL. Quote values containing colons.
pr_titlesubstringCase-insensitive PR title substring match. Quote multi-word values.
sourcecreated_by_me, shared_with_meOwnership scope. Default: created_by_me. Pass both values comma-separated to return owned and shared conversations.
searchtextFull-text search across chat titles, PR titles, PR numbers, and message content. Quote multi-word values.

Multiple filters in one query combine with AND logic. search: cannot be combined with title:, pr_title:, or pr:.

search: uses token-based PostgreSQL full-text search:

  • Case-insensitive whole-word matching with AND semantics. Quoted phrases, OR, and - negation follow websearch_to_tsquery rules.
  • Message content matches English word stems (refactor matches refactoring) and ignores English stopwords. Titles and PR titles do not stem.
  • No fuzzy, semantic, or word-prefix matching.
  • Whole-number values also match PR numbers by prefix: 302 matches PR 30281.
  • A value with no searchable words (punctuation only) returns an empty list. An empty value returns HTTP 400.
  • Results use the standard chat list ordering (pinned first, then most recently updated) and pagination, without match snippets.
  • Message content becomes searchable shortly after it is written (background indexing, usually within 10 minutes). Titles and PR titles are searchable immediately.

Examples

# Title substring (case-insensitive)
?q=title:deploy

# Multi-word title (URL-encode the space or use +)
?q=title:my+project

# Unread conversations
?q=has_unread:true

# Conversations that need you, or that failed
?q=status:requires_action,error

# Conversations with a turn in progress
?q=status:running

# Conversations with open or draft PRs
?q=pr_status:open,draft

# Conversations with no pull request, or an open one
?q=pr_status:none,open

# Filter by diff URL (quote values containing colons)
?q=diff_url:"https://github.com/coder/coder/pull/123"

# Combine filters
?q=title:refactor+has_unread:true+pr_status:merged

# Conversations linked to PR #42
?q=pr:42

# Conversations for a specific repository
?q=repo:coder/coder

# Conversations with a specific PR title
?q=pr_title:"fix auth bug"

# Conversations shared with you, plus your own
?q=source:created_by_me,shared_with_me

# Full-text search across titles, PR titles, and messages
?q=search:"kubernetes restart"

# Combine full-text search with other filters
?q=search:refactor+pr_status:open

Notes

  • status:waiting is an idle conversation, status:running is a turn in progress, and status:interrupting is a turn being stopped.
  • status:requires_action means the agent needs you before it can continue, and status:error means the turn failed.
  • title:, repo:, and pr_title: use ILIKE matching. % and _ act as wildcards.
  • pr_status:draft means the PR is open and marked as a draft. pr_status:open means the PR is open and not a draft.
  • pr_status:none matches conversations with no pull request, including those whose linked PR was cleared.
  • Conversations without a linked diff status are excluded when pr, repo, pr_title, or any pr_status value other than none is set. The repo: filter also matches chats tracking a branch with no PR.
  • Unrecognized keys, bare terms, or combining search: with title:, pr_title:, or pr: return HTTP 400 with a validation error.