Beta module namespace
deploy
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.
13 operations
| Method | Path | Required permission | Authentication | Summary |
|---|---|---|---|---|
| get | /v1/m/deploy/definitions | deploy:deployment:read | Bearer token | Lists definitions, optionally filtered by environment or desired_status. |
| post | /v1/m/deploy/definitions | deploy:deployment:write | Bearer token | Declares a new deployment definition and its first revision. |
| get | /v1/m/deploy/definitions/{id} | deploy:deployment:read | Bearer token | Returns one definition with its current desired spec and, when applied, the real-state snapshot from the core Deployment entity. |
| put | /v1/m/deploy/definitions/{id} | deploy:deployment:write | Bearer token | Declares a new desired revision. |
| delete | /v1/m/deploy/definitions/{id} | deploy:deployment:write | Bearer token | deploy module route (requires deploy:deployment:write) |
| post | /v1/m/deploy/definitions/{id}/apply | deploy:deployment:admin | Bearer token | Reconciles the deployment to its desired spec — a GOVERNED INFRASTRUCTURE MUTATION. |
| post | /v1/m/deploy/definitions/{id}/plan | deploy:deployment:write | Bearer token | deploy module route (requires deploy:deployment:write) |
| post | /v1/m/deploy/definitions/{id}/retire | deploy:deployment:admin | Bearer token | Removes the deployment from the target — a GOVERNED MUTATION with the same two-phase, deny-by-default gating as apply. |
| get | /v1/m/deploy/definitions/{id}/revisions | deploy:deployment:read | Bearer token | Returns the append-only revision history of a definition — the rollback targets. |
| post | /v1/m/deploy/definitions/{id}/rollback | deploy:deployment:write | Bearer token | Rolls the DESIRED state back to a prior revision by declaring a NEW revision whose spec equals that known-good version (forward-only, reversible history). |
| post | /v1/m/deploy/definitions/{id}/verify | deploy:deployment:write | Bearer token | Reconciles the real state against the desired spec and updates the Deployment snapshot's status (drift is reported, not mutated). |
| get | /v1/m/deploy/operations | deploy:deployment:read | Bearer token | Lists the append-only operation ledger, optionally filtered by definition_id, op or status. |
| get | /v1/m/deploy/wirings | deploy:wiring:read | Bearer token | Lists the declared PERMITTED wirings, optionally filtered by definition_id or status. |