FruxonDocs
ApiFruxon channel

Opens a debug session against an agent.

Sandbox by default: the agent's reply is captured here and any other real send during the run is hard-blocked. Returns the new session id, which is also the conversation key for the stream / messages endpoints.

POST
/v1/tenants/{tenant}/fruxon/sessions

Authorization

Bearer
AuthorizationBearer <token>

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

In: header

Path Parameters

tenant*string

The tenant identifier

Request Body

The agent to drive and the delivery mode.

agentId?string|null
deliveryMode?string

How a fruxon debug session's outbound is delivered.

Value in"UNSPECIFIED" | "SANDBOX" | "LIVE"
networkId?string|null

The Network (Application) this debug session is scoped to — the topology the console was launched in. Every turn's run resolves this Network's deployment (escalation ladder, capabilities, operator pool) instead of the Default Network, so testing an agent "in" an Application exercises that Application's config. Omit for an agent-only session (Default Network, current behaviour).

Formatuuid
[key: string]?never

Response Body

curl -X POST "https://api.fruxon.com/v1/tenants/string/fruxon/sessions" \  -H "Content-Type: application/json" \  -d '{}'
{
  "sessionId": "string",
  "agentId": "string",
  "deliveryMode": "SANDBOX",
  "status": "OPEN"
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}
Empty
Empty