Start a workflow run
Starts a deterministic orchestration of multiple agents from a script — by path or inline source — with arguments. The script runs in the host’s confined runtime: no filesystem, no network, no module loading; only the agent API the host provides. Script validation failures return 422 NRY-0010 before anything executes. Progress streams as workflow-progress events.
Body
- Option 1
- Option 2
Request to start a workflow run from a script — exactly one of scriptPath or source.
Response
Run accepted and starting; watch events or poll the run.
A deterministic orchestration run with per-step progress.
pending, running, completed, failed, stopped Reserved response field. The current host snapshots a local path into the run's stored source and does not retain or return the path, so this field is absent for both source forms.
4096The session the run's agents work in, so their transcripts can be read back after the run and after a restart. Absent until the run has started one, and cleared if that session is later purged.
Present when the run itself failed outside any step.

