Resolido Docs
Conversations

Re-run AI (debug)

POST
/conversations/{conversationId}/ai-runs/rerun

Re-run the AI on the latest customer message as a debug run: nothing is sent; lookup (read) skills run live, action skills (refill, restart…) are only recorded with their arguments, never executed. Review it with conversation_ai_trace and send it with conversation_ai_send.

Authorization

bearer conversations:write
headerAuthorizationBearer <token>

API key (rsl_live_…) from Settings → Developers.

Scope: conversations:write

Path Parameters

conversationId*string

Conversation id with channel prefix, e.g. chat_k57… or email_j97….

Match^(chat|email)_[a-z0-9]+$

Request Body

application/json
  1. body
runId?string

Run to repeat; default = the newest run.

readOnly?boolean

Never execute action skills in the replay (default). Chat replays always behave this way; for email, false lets mailbox actions run.

Defaulttrue
waitSeconds?integer

Wait up to this long for the replay to finish and return it (compact trace). 0 = return immediately.

Range0 <= value <= 55
Default0

Response Body

Success

application/json
  1. response
conversationId*string
runId*string
finished*boolean

False when waitSeconds ran out – poll conversation_ai_trace with runId.

run?unknown

The finished run as returned by conversation_ai_trace (compact), when waited for.

curl -X POST "https://example.com/conversations/string/ai-runs/rerun" \  -H "Content-Type: application/json" \  -d '{}'
{  "conversationId": "string",  "runId": "string",  "finished": true,  "run": null}