Get one persistent thread and its messages

GET

/v1/admin/orgs/{org_id}/projects/{project_id}/inboxes/{addr}/threads/{thread_id}

• Production
• Local

Authorizations

• ClerkSession

Parameters

Path Parameters

org_id

required

string

project_id

required

string

addr

required

string

The full inbox address, URL-encoded (e.g. agent7%40extrovertmail.com).

thread_id

required

string

Responses

200

Thread messages, oldest-first.

object

thread_id

string

subject

string

messages

Array<object>

A source-preserving message shape for the console plane.

object

id

string

seq

string

thread_id

string

direction

string

Allowed values: inbound outbound

from

string

to

string

cc

string

reply_to

string

subject

string

date

string

message_id

string

in_reply_to

string

references

string

seen

boolean

has_attachments

boolean

body

string

text

string

html

string

extracted_text

string

extracted_html

string

400

Invalid request.

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

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

404

Resource not found.

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