Skip to main content
POST
Rerun an interaction

Authorizations

Authorization
string
header
required

Access token from POST /management/v1/auth/token (publishable-key exchange) or a login session. Publishable-key tokens are agent-scoped and serve the messaging surface; login tokens also serve management.

Path Parameters

threadId
string
required
Pattern: ^[0-9a-fA-F]{24}$|^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$

Body

application/json

Rerun an interaction: regenerate it on the thread against the agent's live version, then replay text onto the resulting new thread. version_id/version_tag optionally pin a specific version instead of the live one.

interaction_id
string
required
Pattern: ^[0-9a-fA-F]{24}$|^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
text
string
required
Minimum string length: 1
user_id
string | null

End user to attribute the rerun to; omitted, the thread's original user is kept.

image_url
string | null

Signed image URL on the replayed message.

version_id
string | null
Pattern: ^[0-9a-fA-F]{24}$
version_tag
string | null
runtime_version
string | null

Optional runtime build pin (e.g. '0.5.4') for agents on the runtime-v2 engine. Has no effect on which engine serves the agent; omit to use the current default runtime.

Response

Successful Response

Send/rerun reply plus the resolved thread id — the one the interaction landed on (newly created when the request omitted thread_id).

thread_id
string
required

Thread the interaction belongs to

message
Message · object
required

One message in a thread transcript.