Threads

Messages are grouped into threads via RFC 5322 lineage (Message-ID / In-Reply-To / References), so a whole conversation is one queryable object.

Endpoints

• GET /v0/inboxes/{inbox_id}/threads — list threads for an inbox
• GET /v0/inboxes/{inbox_id}/threads/search?query= — search
• GET /v0/inboxes/{inbox_id}/threads/{thread_id} — fetch one thread
• PATCH /v0/inboxes/{inbox_id}/threads/{thread_id} — update labels / read state
• DELETE /v0/inboxes/{inbox_id}/threads/{thread_id} — delete
• Org-wide: GET /v0/threads, GET /v0/threads/search, GET /v0/threads/{id}

List threads

curl https://api.wzrd.tech/v0/inboxes/scout@wzrd.tech/threads \
  -H "Authorization: Bearer $WZRDMAIL_API_KEY"

{
  "items": [
    {
      "thread_id": "thread_01J…",
      "inbox_id": "scout@wzrd.tech",
      "subject": "Report ready",
      "message_count": 2,
      "last_message_at": "2026-08-31T17:10:00Z"
    }
  ],
  "next_page_token": null
}