Edit a queued message's content

PATCH/o/{org}/p/{project}/sessions/{session}/queued-messages/{message}
View .md

Only queued (not yet claimed for delivery) messages can be edited. Auth requires session mutate access (owner or org owner/admin).

Authenticate with an org API key or a signed-in session.

Path parameters

orgstringrequired

The org's slug or id. A caller with no role in the org gets 404.

projectstringrequired

A Project's handle (name) or id, resolved inside {org} — OR the reserved sentinel _ meaning "no Project" (a direct-repo / repo-less dispatch on POST; "no Project constraint, resolve by session id alone" everywhere else). A real handle that doesn't match the session's actual Project is 404.

sessionstringrequired

The session's full id (execution_id).

messagestringrequired

The queued message id.

Request body

contentstringrequired

Responses

200The updated message.
okbooleanrequired
messageQueuedMessagerequired

A follow-up message queued during an active turn.

11 fields
idstringrequired
Format uuid
execution_idstringrequired
user_idstringrequired
contentstringrequired
statusstringrequired
One ofqueueddeliveringdeliveredfailed
positionintegerrequired

1-based FIFO position.

created_atstringrequired
Format date-time
claimed_atstring | nulloptional
Format date-time
delivered_atstring | nulloptional
Format date-time
errorstring | nulloptional

Delivery failure reason (set on failed status).

attempt_countintegerrequired

Number of delivery attempts.

400Malformed request.
errorstringoptional

A sentence for a person.

codestringoptional

Stable machine code, e.g. AUTH_FAILED, NOT_FOUND, VALIDATION_ERROR, RATE_LIMITED, PLAN_REQUIRED.

error_codestringoptional

The machine code on routes that name it this way.

messagestringoptional
requestIdstringoptional
401No bearer, an unknown, revoked or expired one, or an API key on a route keys cannot call.
errorstringoptional

A sentence for a person.

codestringoptional

Stable machine code, e.g. AUTH_FAILED, NOT_FOUND, VALIDATION_ERROR, RATE_LIMITED, PLAN_REQUIRED.

error_codestringoptional

The machine code on routes that name it this way.

messagestringoptional
requestIdstringoptional
404No such resource for the caller, including one that exists in an org the caller cannot see.
errorstringoptional

A sentence for a person.

codestringoptional

Stable machine code, e.g. AUTH_FAILED, NOT_FOUND, VALIDATION_ERROR, RATE_LIMITED, PLAN_REQUIRED.

error_codestringoptional

The machine code on routes that name it this way.

messagestringoptional
requestIdstringoptional
409The message is no longer editable (already claimed for delivery).
errorstringoptional

A sentence for a person.

codestringoptional

Stable machine code, e.g. AUTH_FAILED, NOT_FOUND, VALIDATION_ERROR, RATE_LIMITED, PLAN_REQUIRED.

error_codestringoptional

The machine code on routes that name it this way.

messagestringoptional
requestIdstringoptional