GET · Bearer

GET /api/v1/inboxes/:id/threads?limit=20

All endpoints · Markdown

Summary

List conversations in one inbox, newest activity first. A thread is computed from messages that share a thread_id. limit is 1–100 (default 20). before and after are ISO-8601 bounds on updated_at. ascending=true reverses the order. page_token is the base64url of updated_at and thread_id. A bad token returns 400 invalid_page_token. Each thread includes subject (first message), preview (latest), senders, recipients (distinct to and cc), message_count, labels (union), attachment_count, received_at, and sent_at.

Query

?limit=20&ascending=false

Response

The OpenAPI document does not declare a JSON response schema for this call. The summary is the contract.

Errors

  • HTTP 400 invalid_page_token

Idempotency

This route does not document Idempotency-Key or client_id.