Jump to

Threads

Threads group related messages into conversations. They are created automatically when messages are sent or received — you cannot create a thread directly. Threads are ordered by most recent activity.

List threads GET

GET /mailboxes/{email_address}/threads

List threads for a mailbox with cursor pagination, ordered by most recent message activity.

Path parameters

Parameter	Type	Description
`email_address`	string	Email address of the mailbox

Query parameters

Parameter	Type	Default	Description
`cursor`	string	—	Opaque cursor from a previous response's `next_cursor`
`limit`	integer	50	Results per page (1–100)

Response (200)

JSON

Code examples

Get thread GET

GET /mailboxes/{email_address}/threads/{thread_id}

Get a single thread with all its messages (metadata only — no body content) inline.

Path parameters

Parameter	Type	Description
`email_address`	string	Email address of the mailbox
`thread_id`	UUID	Unique identifier of the thread

Response (200)

JSON

Code examples

Delete thread DELETE

DELETE /mailboxes/{email_address}/threads/{thread_id}

Delete a thread. Returns 204 No Content on success.

Path parameters

Parameter	Type	Description
`email_address`	string	Email address of the mailbox
`thread_id`	UUID	Unique identifier of the thread

Code examples

Thread object

ThreadResponse (list items)

Field	Type	Description
`id`	UUID	Unique thread identifier
`mailbox_id`	UUID	Owning mailbox
`subject`	string \| null	Subject from the first message in the thread
`status`	string	Lifecycle status: `active`, `paused`, `deleted`
`message_count`	integer	Number of messages in the thread
`last_message_at`	string	Timestamp of the most recent message (ISO 8601)
`created_at`	string	Thread creation timestamp (ISO 8601)

ThreadDetailResponse (single thread)

Includes all ThreadResponse fields plus:

Field	Type	Description
`messages`	MessageResponse[]	All active messages in the thread (metadata only, no body content)