Thread-aware console reply from an org inbox

POST

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

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

Request Body ^required

One of:

object

Thread-aware reply. Exactly one of thread_id / message_id selects the parent; recipients, subject, and threading headers are derived server-side.

object

thread_id

required

string

message_id

string

text

string

html

string

cc

Array<string>

bcc

Array<string>

reply_to

string

headers

object

key

additional properties

string

reply_all

Include all original recipients (reply-all) when true.

boolean

expected_last_message_id

Optional stale-context guard; returns 409 if the thread head changed before request materialization.

string

attachments

Array<object>

An outbound attachment on send/reply/forward.

object

filename

string

content_type

string

content_base64

required

Standard base64-encoded attachment bytes.

string

mode

Review Loop per-send assertion (see SendRequest.mode).

string

Allowed values: review direct

intent

The agent’s “for the human reviewer” summary. summary is REQUIRED when the resolved mode is review (else the submit is 422).

object

summary

Free-text intent summary (who/what/why).

string

meta

Structured intent payload.

object

goal

string

recipient

string

prior_touches

integer

urgency

string

category_id

Opaque category id (cat_…) matched from the registry.

string

category_confidence

Agent-supplied confidence (0..1) in the category match (see SendRequest.category_confidence). Feeds the min_confidence auto-send gate only; the server never scores.

number format: float

<= 1

composition_token

Opaque token from a fresh, unfiltered GET /v1/rules for this agent, project, and category.

string

idempotency_key

DEPRECATED body-level alias for the Idempotency-Key header (see SendRequest.idempotency_key). Send the header instead.

string

object

Thread-aware reply. Exactly one of thread_id / message_id selects the parent; recipients, subject, and threading headers are derived server-side.

object

thread_id

string

message_id

required

string

text

string

html

string

cc

Array<string>

bcc

Array<string>

reply_to

string

headers

object

key

additional properties

string

reply_all

Include all original recipients (reply-all) when true.

boolean

expected_last_message_id

Optional stale-context guard; returns 409 if the thread head changed before request materialization.

string

attachments

Array<object>

An outbound attachment on send/reply/forward.

object

filename

string

content_type

string

content_base64

required

Standard base64-encoded attachment bytes.

string

mode

Review Loop per-send assertion (see SendRequest.mode).

string

Allowed values: review direct

intent

The agent’s “for the human reviewer” summary. summary is REQUIRED when the resolved mode is review (else the submit is 422).

object

summary

Free-text intent summary (who/what/why).

string

meta

Structured intent payload.

object

goal

string

recipient

string

prior_touches

integer

urgency

string

category_id

Opaque category id (cat_…) matched from the registry.

string

category_confidence

Agent-supplied confidence (0..1) in the category match (see SendRequest.category_confidence). Feeds the min_confidence auto-send gate only; the server never scores.

number format: float

<= 1

composition_token

Opaque token from a fresh, unfiltered GET /v1/rules for this agent, project, and category.

string

idempotency_key

DEPRECATED body-level alias for the Idempotency-Key header (see SendRequest.idempotency_key). Send the header instead.

string

Responses

202

Accepted for delivery.

The outcome of a reply or forward.

object

message_id

string

thread_id

string

review_id

Opaque review id (rr_…) for the review row that governed this send. ADDITIVE. Every agent-plane send now creates one, so an agent that crashes after issuing the request can still call GET /v1/reviews/{id} and read closed / sent_message_id instead of guessing whether the message went out.

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