Skip to content
Extrovert Extrovert Docs

List conversation threads (newest-first)

GET
/v1/inboxes/{inbox_id}/threads

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
inbox_id
required
string

Opaque inbox id (the canonical path key). The inbox’s email address is also accepted here as a within-project alias. Treat the id as opaque.

Query Parameters

Section titled “Query Parameters ”
limit
integer
default: 50 >= 1 <= 100

Page size for the cursor-paginated agent surface (default 50; clamped to the 1-100 range).

cursor
string

Opaque pagination cursor echoed back from a prior next_cursor. Treat it as an opaque token; pass it back verbatim as ?cursor to fetch the next page.

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Ok

object
items
Array<object>

A conversation backed by the mail server’s persistent thread index.

object
id
string
Example
thr_9aB
inbox_id
string
Example
agent7@extrovertmail.com
subject
string
participants
Array<string>
message_count
integer
last_message_at
string
snippet
string
unread

Whether the latest message is unread.

boolean
last_message_id

Opaque id of the latest message; usable by message endpoints.

string
last_message_has_attachments

Whether the latest message has attachments.

boolean
total
integer
next_cursor
string

401

Section titled “401 ”

Missing or invalid credential.

The canonical error envelope. error is a stable machine code.

object
error
required

Stable error code (e.g. unauthorized, forbidden, not_found, invalid, quota_exceeded, rate_limited).

string
Example
forbidden
message

Human-readable detail (never leaks internals).

string
Example
missing required scope

403

Section titled “403 ”

Authenticated but lacking the required scope, or out of quota.

The canonical error envelope. error is a stable machine code.

object
error
required

Stable error code (e.g. unauthorized, forbidden, not_found, invalid, quota_exceeded, rate_limited).

string
Example
forbidden
message

Human-readable detail (never leaks internals).

string
Example
missing required scope