Retry a failed queued message

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

Resets a failed message back to queued status and triggers a drain attempt. Auth requires session mutate access.

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.

Responses

200The retried message (status reset to queued).
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.

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
409Only failed messages can be retried (code NOT_FAILED).
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