List recent messages for an org inbox

GET

/v1/admin/orgs/{org_id}/projects/{project_id}/inboxes/{addr}/messages

• 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).

Query Parameters

folder

string

IMAP folder to read (default INBOX).

limit

integer

default: 50 >= 1 <= 100

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

Responses

200

Ok

object

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

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