FruxonDocs
ApiAgentdraft

Enqueues a draft test turn as a <em>queued</em> run and returns the session to stream from — the async-capable sibling of M:Fruxon.Server.Controllers.AgentRevisions.AgentDraftController.StreamTest(System.String,System.String,Fruxon.Server.Controllers.AgentExecutionRequestView,System.Threading.CancellationToken).

`:test` / `:streamTest` run synchronously on the non-queued path, where async tools (approval / consult / `spawn_subtask`) can't park and instead error out. This endpoint parks the run on the queue pinned to the current draft snapshot, so those capabilities actually suspend and resume. The reply — and any parked-state frames — arrive on the FruxonChannel session stream (`GET fruxonChannel/sessions/{session}/stream`) named by the returned session id. delivery selects Contained (`SANDBOX`, default) vs `LIVE`; the tool-credentials mode (Sandbox vs Production) rides `Mode` on the request body, orthogonally.

POST
/v1/tenants/{tenant}/agents/{agent}/revisions/{revision}/draft:queueTest

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 unique identifier of the agent.

revision*string

The base revision the draft forks from.

tenant*string

The tenant identifier

Query Parameters

delivery?string

Delivery mode: SANDBOX (default, contained) or LIVE (real sends).

Value in"UNSPECIFIED" | "SANDBOX" | "LIVE"

Request Body

The execution parameters and inputs for the test run.

parameters?

Key-value parameters to pass to the agent

attachments?

File attachments for the execution. Each entry references a file already uploaded through POST /storage; they are attached to the run's user turn, so a vision-capable model receives the images directly and every file stays addressable by its <fileType:fileId/> link. Maximum 20.

sessionId?string|null

Optional session ID for conversation continuity

mode?string

Integration-config variant this execution resolves against. Honoured on the draft-test endpoints; :execute / :stream run a deployed revision and always resolve Production configs, so the value is ignored there.

Value in"UNSPECIFIED" | "PRODUCTION" | "SANDBOX"
environmentSlug?string|null

Optional environment slug for per-end-customer cost tracking and analytics. Auto-creates the environment on first use (subject to the per-tenant environment cap).

Lengthlength <= 64
[key: string]?never

Response Body

curl -X POST "https://api.fruxon.com/v1/tenants/string/agents/string/revisions/string/draft:queueTest" \  -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
{
  "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
}