Fires one of the session agent's triggers into the sandbox.

The agent reacts to the trigger with its real output-destination send (and any mid-run send) captured / hard-blocked — the captured reply and blocked notices arrive on the stream / messages endpoints, same as a participant turn. Only bindings selecting the session's agent fire. Sandbox sessions only; a real fire belongs on `POST /triggers/{trigger}:fire`.

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 session id returned by open.

tenant*string

The tenant identifier

Request Body

The trigger to fire and an optional sample payload.

triggerId?string

The trigger to fire. Must be bound to the session's agent.

Formatuuid

samplePayload?|null

Optional synthesized event body for IntegrationEvent triggers — nests under TriggerFirePayload.Body["payload"], same as POST /triggers/{trigger}:fire. Rejected (400) for other kinds.

parameterOverrides?|null

Optional per-fire overrides of the resolved agent input, keyed by parameter name (e.g. user_query). Applied after the binding's mappings resolve, so each entry wins over the resolved value — even a LITERAL mapping. Lets an operator test a trigger-driven run with specific input from the debug console without editing the persisted binding. Sandbox-only; never persisted. Unset (or omitting a parameter) reproduces the binding's resolved input exactly.

asyncExecutionMode?string

Optional per-fire async-execution-mode override (sandbox debug console). Forces this run's async tools (consult / approval / delegate) to await or background, winning over each step's deployed AsyncExecution.Mode for this fire only — so an operator can exercise the suspend-and-answer loop without redeploying the agent. Omitted (or UNSPECIFIED) = no override: the deployed step config applies (current behavior). Honoured only for sandbox sessions; nothing is persisted to the agent. See docs/design/async-execution-mode.md §7.

Value in"UNSPECIFIED" | "AGENT_DECIDES" | "FORCE_AWAIT" | "FORCE_BACKGROUND"

[key: string]?never

Response Body

curl -X POST "https://api.fruxon.com/v1/tenants/string/fruxon/sessions/string:fireTrigger" \
  -H "Content-Type: application/json" \
  -d '{}'

curl -X POST "https://api.fruxon.com/v1/tenants/string/fruxon/sessions/string:fireTrigger" \  -H "Content-Type: application/json" \  -d '{}'

Empty

{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}