Search the archived conversation archive
Cursor-paginated search over the tenant’s archived conversations — the discovery half of the cross-channel handover feature (GET /conversations/export is the extraction half). Narrow by a natural-language free-text (q or legacy search) over contact name / phone / email and the GIN-indexed message body, plus every filter axis the unified-inbox list accepts (channels, date range, assignee, tags, segment, saved-view filter AST). The result set is confined to status=‘archived’ server-side — a closed or active conversation can never leak into the archive surface, and any contradictory status= param on the request is replaced by the archived confinement. Cursor-paginated (limit 1-100, default 25); follow pagination.cursor when has_more is true. Pair it with GET /conversations/export?format=json&include_messages=true on the same filters for the extraction half (full transcripts).
Authorizations
Dashboard JWT token from Clerk
Headers
Sandbox opt-in for Clerk-session-authenticated requests. Set to true to route the call through the test-mode pipeline: no real provider delivery, no credits deducted, response meta.test_mode: true. Ignored for live API keys (dv_live_sk_*) — server-to-server clients must use a test-prefixed key (dv_test_sk_*) to exercise sandbox. Test-prefixed keys unconditionally enable sandbox regardless of this header.
true, false Query Parameters
Natural-language free-text (contact name / phone / email + message body). Wins over search when both are present.
1 <= x <= 100Sort field (prefix with - for DESC)
sms, whatsapp, email, rcs, viber, instagram, messenger, line, telegram, agent, voice, video, apple_messages, web_chat, wechat, kakao, zalo IGNORED server-side — the archive confinement (status='archived') always replaces it.
Legacy alias of q.
true, false true, false true, false positive, neutral, negative true, false inbound, outbound Response
Successful response.