Threads

GET /v0/emails/threads (org) · /v0/emails/inboxes/:inbox_id/emails/threads… · /v0/projects/:project_id/threads…, plus GET …/search.

List & filter

GET /v0/emails/inboxes/:inbox_id/emails/threads?labels=vip&senders=user@&before=…&after=…&ascending=

Substring filters: senders, recipients, subject (repeatable, AND). Gated labels (spam, trash, blocked, unauthenticated) are hidden unless the key holds the matching label_*_read permission; include_spam=false etc. force-exclude them.

Search

GET /v0/emails/inboxes/:inbox_id/emails/threads/search?q=vip+renewal

Matches senders/recipients/subject (substring) plus tokenized bodies, ranked by relevance. Gated labels are always excluded. limit ≤ 100.

Labels

PATCH /v0/emails/inboxes/:inbox_id/emails/threads/:thread_id:

{ "add_labels": ["vip"], "remove_labels": ["new"] }

System labels (sent, received, bounced, spam, trash, blocked, …) cannot be added or removed — 400. Threads with 100+ messages reject relabeling (422). Every change records a label.added / label.removed inbox event. GET returns the thread with messages[] ascending. DELETE removes the thread and all its messages.

⌘I