Beta module namespace
orchestration
Beta routes may change with notice and are NOT covered by the 24-month stable window of the core contract.
Every module route is enumerated with method, path, auth and required permission; request/response schemas are not published for the beta surface.
25 operations
| Method | Path | Required permission | Authentication | Summary |
|---|---|---|---|---|
| get | /v1/m/orchestration/decisions | orchestration:schedule:read | Bearer token | Lists the whole append-only fire/miss ledger for the tenant. |
| get | /v1/m/orchestration/flows | orchestration:graph:read | Bearer token | Returns the derived multi-agent flows (a supervisor and the workers it delegates to) with a read-time-derived lifecycle state — a privileged, self-audited read. |
| get | /v1/m/orchestration/graph | orchestration:graph:read | Bearer token | Returns the React-Flow communication/delegation graph, derived from the relation table, with honest coverage. |
| get | /v1/m/orchestration/graph/neighbors | orchestration:graph:read | Bearer token | Returns the subgraph around one node (its incoming and/or outgoing relations) — a privileged, self-audited read. |
| get | /v1/m/orchestration/schedules | orchestration:schedule:read | Bearer token | Lists governed schedules. |
| post | /v1/m/orchestration/schedules | orchestration:schedule:write | Bearer token | Declares a governed schedule (write-tier, self-audited). |
| get | /v1/m/orchestration/schedules/{id} | orchestration:schedule:read | Bearer token | Returns one schedule with its derived health and last observed activity. |
| patch | /v1/m/orchestration/schedules/{id} | orchestration:schedule:write | Bearer token | Enables/disables/retargets a schedule (write-tier, self-audited). |
| get | /v1/m/orchestration/schedules/{id}/decisions | orchestration:schedule:read | Bearer token | Lists the append-only fire/miss ledger for one schedule. |
| post | /v1/m/orchestration/schedules/{id}/fire | orchestration:schedule:admin | Bearer token | orchestration module route (requires orchestration:schedule:admin) |
| post | /v1/m/orchestration/schedules/{id}/restore | orchestration:schedule:write | Bearer token | Re-applies the mutable shape of an earlier revision via the patch verb's exact application path (same validation, same cadence-miss clearing, same plan_hash consequence). |
| get | /v1/m/orchestration/schedules/{id}/revisions | orchestration:schedule:read | Bearer token | Lists a schedule's revision ledger, keyset-paginated by the time-ordered row id (chronological by ingestion, the decision-ledger convention). |
| get | /v1/m/orchestration/stream | orchestration:graph:read | Bearer token | Serves the live comm graph as server-sent events, pinned to the request's single authorized tenant so a client only ever sees its own tenant's relations. |
| get | /v1/m/orchestration/timeline | orchestration:graph:read | Bearer token | Returns one subject's merged orchestration history (its delegation activity and its fire/miss decisions) in reverse-chronological order — a privileged, self-audited read. |
| get | /v1/m/orchestration/workflows | orchestration:workflow:read | Bearer token | Lists the tenant's workflows (list shape, no graphs). |
| post | /v1/m/orchestration/workflows | orchestration:workflow:write | Bearer token | Declares a workflow (write-tier, self-audited, revisioned). |
| get | /v1/m/orchestration/workflows/{id} | orchestration:workflow:read | Bearer token | Returns one workflow with its full canonical graph. |
| patch | /v1/m/orchestration/workflows/{id} | orchestration:workflow:write | Bearer token | Updates description/enabled (write-tier, revisioned). |
| post | /v1/m/orchestration/workflows/{id}/dry-run | orchestration:workflow:read | Bearer token | Computes the execution plan for a workflow as declared, with ZERO effects (read-tier). |
| post | /v1/m/orchestration/workflows/{id}/restore | orchestration:workflow:write | Bearer token | Re-applies the MUTABLE shape of an earlier revision — description, enabled, steps — through the exact same validation as the live verbs (the restore rule). |
| get | /v1/m/orchestration/workflows/{id}/revisions | orchestration:workflow:read | Bearer token | Lists a workflow's append-only revision ledger. |
| post | /v1/m/orchestration/workflows/{id}/run | orchestration:workflow:admin | Bearer token | orchestration module route (requires orchestration:workflow:admin) |
| get | /v1/m/orchestration/workflows/{id}/runs | orchestration:workflow:read | Bearer token | Lists a workflow's runs, newest-first pagination by id. |
| get | /v1/m/orchestration/workflows/{id}/runs/{run} | orchestration:workflow:read | Bearer token | Returns one run's timeline. |
| put | /v1/m/orchestration/workflows/{id}/steps | orchestration:workflow:write | Bearer token | Replaces the whole step graph atomically (write-tier, revisioned). |