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.

POST
/v1/tenants/{tenant}/fruxon/sessions/{session}:rewind

Authorization

Bearer
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

Request Body

The run whose turn becomes the first one dropped.

executionRecordId?string

The run behind the agent reply the operator pointed at, as returned in Fruxon.Model.FruxonChannel.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
}