FruxonDocs
ApiAgent reviews

Tests a recommendation card's change in the sandbox, before approving it.

The conversation that raised the card — `unitId`, or else the most recent one behind it — is forked into a new sandbox session, up to the customer message the finding points at. Send `fork.prefillText` on that session with `revisionPolicy: PROPOSAL` and this card's id, and the turn runs the change made to the deployed release in memory: the agent answers as approving the card would have it answer. Nothing is saved — no revision, no change to the card, no draft — and later turns on the session run the change the same way. Tools run for real, as on any sandbox turn: send with `confirmToolCalls` to hold the ones that change things. When no conversation behind the card can be forked (a run with no conversation, or one that has aged out), `fork` is null: open a sandbox session and write the message yourself. Agent admins only.

POST
/v1/tenants/{tenant}/agents/{agent}/recommendations/{recommendation}:test

Authorization

Bearer
AuthorizationBearer <token>

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

In: header

Path Parameters

agent*string

The agent ID.

recommendation*string

The recommendation ID.

Formatuuid
tenant*string

The tenant identifier

Request Body

Which of the card's conversations to test on.

unitId?string|null

A reviewed conversation behind the card — an evidence[].unit.id of the card's detail. Omit for the most recent one.

Formatuuid
[key: string]?never

Response Body

curl -X POST "https://api.fruxon.com/v1/tenants/string/agents/string/recommendations/497f6eca-6276-4993-bfeb-53cbbbba6f08:test" \  -H "Content-Type: application/json" \  -d '{}'
{
  "baseRevision": 0,
  "unitId": "00000000-0000-0000-0000-000000000000",
  "anchorMessageId": 0,
  "fork": {
    "sessionId": "string",
    "agentId": "string",
    "participantId": "00000000-0000-0000-0000-000000000000",
    "networkId": "00000000-0000-0000-0000-000000000000",
    "sourceSessionId": "string",
    "targetSessionId": "string",
    "topicId": "00000000-0000-0000-0000-000000000000",
    "flow": "string",
    "copiedMessages": 0,
    "prefillText": "string",
    "prefillOccurredAt": 0
  }
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}
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
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}