threads
threads

List Threads

List conversation threads with pagination and filtering.

Returns threads from all channels for the current user. Uses workspace-aware database routing (Supabase or shared DB).

get/api/threads

Request

  • Base URL: https://api.dialogbrain.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.dialogbrain.com/api/threads
  • Auth: none declared

Query parameters

limitinteger
offsetinteger
searchstring nullable

Search in thread title

emailstring nullable

Search by email address in thread participants

channelstring nullable

Filter by channel type (single)

channelsstring nullable

Filter by channel types (comma-separated, e.g. telegram,google_calendar)

kindstring nullable

Filter by thread kind: dm, group, channel (single)

kindsstring nullable

Filter by thread kinds (comma-separated, e.g. group,channel,comment_thread)

needs_replyboolean nullable

Filter threads where last message is inbound and user hasn't replied

statestring nullable

Filter by contact state: new, follow_up, active, warm, cooling, dormant, low

account_idsstring nullable

Filter by channel account IDs (comma-separated, e.g. 229,230). Only applies when a single channel filter is active.

folder_idinteger nullable

Filter by inbox folder ID

ai_tag_idinteger nullable

Filter by AI tag ID

assigned_tostring nullable

Filter by assignment: 'me' for threads assigned to current user, 'unassigned' for threads with no assignment

idsstring nullable

Filter by thread IDs (comma-separated)

unread_onlyboolean nullable

Filter threads with unread messages (unread_count > 0)

escalatedboolean nullable

Filter threads with an open human escalation (ai_agent_escalations status pending/acknowledged)

sortstring nullable

'unread_first': threads with unread messages above the rest (pinned stay on top); otherwise newest first

Response

Successful Response

unknown required

Changes

No recorded changes to this operation across all 5 revisions of this API.