FruxonDocs
ApiFruxon channel

Rewinds a sandbox session to just before one of its turns.

Point at an agent reply (its `executionRecordId` from the messages endpoint) and the reply, the message it answered, and every turn after them are dropped from the session's history and transcript. The dropped message comes back as `prefillText` so the caller re-sends it — verbatim or edited — against the edited agent, and can do so again after the next attempt. The session keeps its id; only the rows go. Runs parked on an approval among the dropped turns are cancelled, so a held write cannot be approved later. The dropped runs' execution records and traces are kept. Sandbox sessions only (400 on a live session); 404 for a run that is not on this session; 409 while a turn is still running or queued.

POST
/v1/tenants/{tenant}/fruxon/sessions/{session}:rewind
AuthorizationBearer <token>

JWT Authorization header using the Bearer scheme. Enter 'Bearer' [space] and then your token.

In: header

Path Parameters

session*string

The sandbox session to rewind.

tenant*string

The tenant identifier

The run whose turn becomes the first one dropped.

executionRecordId?string

The run behind the agent reply the operator pointed at, as returned in FruxonMessageView.ExecutionRecordId. Its turn is the first one dropped: the reply, the message it answered, and everything after.

Formatuuid
[key: string]?never

Response Body

curl -X POST "https://api.fruxon.com/v1/tenants/string/fruxon/sessions/string:rewind" \  -H "Content-Type: application/json" \  -d '{}'
{
  "sessionId": "string",
  "targetSessionId": "string",
  "droppedRuns": 0,
  "cancelledRuns": 0,
  "droppedMessages": 0,
  "droppedConsoleRows": 0,
  "prefillText": "string",
  "prefillOccurredAt": 0
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}
Empty
Empty
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}