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}$

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}$
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

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.