List persistent threads for an org inbox

GET

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

• 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

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

200

Ok

A cursor page of persistent thread summaries for one inbox.

object

threads

Array<object>

One row in the shared-inbox feed, tagged with its owning inbox.

object

id

string

inbox

string

subject

string

participants

Array<string>

message_count

integer

last_message_at

string

snippet

string

unread

boolean

last_message_id

string

last_message_has_attachments

boolean

total

integer

next_cursor

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