Beta module namespace
sessions
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.
67 operations
| Method | Path | Required permission | Authentication | Summary |
|---|---|---|---|---|
| get | /v1/m/sessions/decisions | sessions:decision:read | Bearer token | sessions module route (requires sessions:decision:read) |
| post | /v1/m/sessions/decisions | sessions:decision:write | Bearer token | sessions module route (requires sessions:decision:write) |
| get | /v1/m/sessions/decisions/{id} | sessions:decision:read | Bearer token | sessions module route (requires sessions:decision:read) |
| post | /v1/m/sessions/decisions/{id}/revoke | sessions:decision:admin | Bearer token | sessions module route (requires sessions:decision:admin) |
| get | /v1/m/sessions/leases | sessions:lease:read | Bearer token | sessions module route (requires sessions:lease:read) |
| get | /v1/m/sessions/live | sessions:live:read | Bearer token | Lists live sessions, most-recently-active first. |
| get | /v1/m/sessions/live/{ref} | sessions:live:read | Bearer token | Returns the full live operation of one session by its reference. |
| get | /v1/m/sessions/live/{ref}/timeline | sessions:live:read | Bearer token | Returns a session's reconstructable timeline in chronological (ingestion) order, keyset-paginated by the time-ordered row id. |
| get | /v1/m/sessions/protocol-binding-specs | sessions:protocol-binding:read | Bearer token | Lists protocol binding spec generations in one workspace. |
| post | /v1/m/sessions/protocol-binding-specs | sessions:protocol-binding:write | Bearer token | Records a new draft generation of a protocol binding spec. |
| get | /v1/m/sessions/protocol-binding-specs/{id} | sessions:protocol-binding:read | Bearer token | Returns one immutable protocol binding spec generation. |
| post | /v1/m/sessions/protocol-binding-specs/{id}/activate | sessions:protocol-binding:admin | Bearer token | Makes one spec generation the active desired state for its binding. |
| post | /v1/m/sessions/protocol-binding-specs/{id}/disable | sessions:protocol-binding:admin | Bearer token | Stops one spec generation from being the active desired state. |
| get | /v1/m/sessions/protocol-bindings | sessions:protocol-binding:read | Bearer token | Lists the protocol bindings visible to the caller, filtered and paginated by the query. |
| get | /v1/m/sessions/protocol-bindings/{id} | sessions:protocol-binding:read | Bearer token | Returns one protocol binding in the caller's tenant. |
| post | /v1/m/sessions/protocol-bindings/{id}/reconcile | sessions:protocol-binding:write | Bearer token | Drives one binding towards its desired state. |
| get | /v1/m/sessions/runs | sessions:run:read | Bearer token | sessions module route (requires sessions:run:read) |
| post | /v1/m/sessions/runs | sessions:run:write | Bearer token | sessions module route (requires sessions:run:write) |
| get | /v1/m/sessions/runs/{ref} | sessions:run:read | Bearer token | sessions module route (requires sessions:run:read) |
| delete | /v1/m/sessions/runs/{ref} | sessions:run:admin | Bearer token | sessions module route (requires sessions:run:admin) |
| get | /v1/m/sessions/runs/{ref}/attach | sessions:run:read | Bearer token | Streams a live session's bridged I/O as server-sent events, replaying from an optional ?from=<seq> cursor. |
| post | /v1/m/sessions/runs/{ref}/cleanup | sessions:run:admin | Bearer token | sessions module route (requires sessions:run:admin) |
| get | /v1/m/sessions/runs/{ref}/events | sessions:run:read | Bearer token | sessions module route (requires sessions:run:read) |
| post | /v1/m/sessions/runs/{ref}/input | sessions:run:write | Bearer token | sessions module route (requires sessions:run:write) |
| post | /v1/m/sessions/runs/{ref}/resume | sessions:run:write | Bearer token | sessions module route (requires sessions:run:write) |
| post | /v1/m/sessions/runs/{ref}/stop | sessions:run:write | Bearer token | sessions module route (requires sessions:run:write) |
| get | /v1/m/sessions/stream | sessions:live:read | Bearer token | Serves the live operation as server-sent events. |
| get | /v1/m/sessions/templates | sessions:template:read | Bearer token | sessions module route (requires sessions:template:read) |
| post | /v1/m/sessions/templates | sessions:template:write | Bearer token | sessions module route (requires sessions:template:write) |
| get | /v1/m/sessions/templates/{id} | sessions:template:read | Bearer token | sessions module route (requires sessions:template:read) |
| put | /v1/m/sessions/templates/{id} | sessions:template:write | Bearer token | sessions module route (requires sessions:template:write) |
| delete | /v1/m/sessions/templates/{id} | sessions:template:admin | Bearer token | sessions module route (requires sessions:template:admin) |
| post | /v1/m/sessions/templates/{id}/apply | sessions:template:read | Bearer token | sessions module route (requires sessions:template:read) |
| post | /v1/m/sessions/templates/{id}/duplicate | sessions:template:write | Bearer token | sessions module route (requires sessions:template:write) |
| post | /v1/m/sessions/work-events/{event_id}/replay | sessions:work:admin | Bearer token | sessions module route (requires sessions:work:admin) |
| get | /v1/m/sessions/work-items | sessions:work:read | Bearer token | sessions module route (requires sessions:work:read) |
| post | /v1/m/sessions/work-items | sessions:work:write | Bearer token | sessions module route (requires sessions:work:write) |
| get | /v1/m/sessions/work-items/{id} | sessions:work:read | Bearer token | sessions module route (requires sessions:work:read) |
| patch | /v1/m/sessions/work-items/{id} | sessions:work:write | Bearer token | sessions module route (requires sessions:work:write) |
| get | /v1/m/sessions/work-items/{id}/acceptance | sessions:work:read | Bearer token | sessions module route (requires sessions:work:read) |
| post | /v1/m/sessions/work-items/{id}/acceptance | sessions:work:write | Bearer token | sessions module route (requires sessions:work:write) |
| patch | /v1/m/sessions/work-items/{id}/acceptance/{criterion_id} | sessions:work:write | Bearer token | sessions module route (requires sessions:work:write) |
| post | /v1/m/sessions/work-items/{id}/assignments | sessions:work:admin | Bearer token | sessions module route (requires sessions:work:admin) |
| get | /v1/m/sessions/work-items/{id}/dependencies | sessions:work:read | Bearer token | sessions module route (requires sessions:work:read) |
| post | /v1/m/sessions/work-items/{id}/dependencies | sessions:work:write | Bearer token | sessions module route (requires sessions:work:write) |
| delete | /v1/m/sessions/work-items/{id}/dependencies/{dep_id} | sessions:work:write | Bearer token | sessions module route (requires sessions:work:write) |
| get | /v1/m/sessions/work-items/{id}/events | sessions:work:read | Bearer token | sessions module route (requires sessions:work:read) |
| get | /v1/m/sessions/work-items/{id}/lease | sessions:lease:read | Bearer token | sessions module route (requires sessions:lease:read) |
| post | /v1/m/sessions/work-items/{id}/lease/acquire | sessions:lease:write | Bearer token | sessions module route (requires sessions:lease:write) |
| post | /v1/m/sessions/work-items/{id}/lease/clock-rebase | sessions:lease:admin | Bearer token | sessions module route (requires sessions:lease:admin) |
| post | /v1/m/sessions/work-items/{id}/lease/release | sessions:lease:write | Bearer token | sessions module route (requires sessions:lease:write) |
| post | /v1/m/sessions/work-items/{id}/lease/renew | sessions:lease:write | Bearer token | sessions module route (requires sessions:lease:write) |
| post | /v1/m/sessions/work-items/{id}/lease/revoke | sessions:lease:admin | Bearer token | sessions module route (requires sessions:lease:admin) |
| post | /v1/m/sessions/work-items/{id}/lease/takeover | sessions:lease:admin | Bearer token | sessions module route (requires sessions:lease:admin) |
| post | /v1/m/sessions/work-items/{id}/transitions | sessions:work:write | Bearer token | sessions module route (requires sessions:work:write) |
| get | /v1/m/sessions/work-stream | sessions:work:read | Bearer token | sessions module route (requires sessions:work:read) |
| get | /v1/m/sessions/workspaces | sessions:workspace:read | Bearer token | sessions module route (requires sessions:workspace:read) |
| post | /v1/m/sessions/workspaces | sessions:workspace:admin | Bearer token | sessions module route (requires sessions:workspace:admin) |
| get | /v1/m/sessions/workspaces/{ref} | sessions:workspace:read | Bearer token | sessions module route (requires sessions:workspace:read) |
| delete | /v1/m/sessions/workspaces/{ref} | sessions:workspace:admin | Bearer token | sessions module route (requires sessions:workspace:admin) |
| get | /v1/m/sessions/workspaces/{ref}/files | sessions:workspace:read | Bearer token | sessions module route (requires sessions:workspace:read) |
| delete | /v1/m/sessions/workspaces/{ref}/files | sessions:workspace:write | Bearer token | sessions module route (requires sessions:workspace:write) |
| post | /v1/m/sessions/workspaces/{ref}/files/dir | sessions:workspace:write | Bearer token | sessions module route (requires sessions:workspace:write) |
| post | /v1/m/sessions/workspaces/{ref}/files/move | sessions:workspace:write | Bearer token | sessions module route (requires sessions:workspace:write) |
| get | /v1/m/sessions/workspaces/{ref}/files/raw | sessions:workspace:read | Bearer token | sessions module route (requires sessions:workspace:read) |
| put | /v1/m/sessions/workspaces/{ref}/files/raw | sessions:workspace:write | Bearer token | sessions module route (requires sessions:workspace:write) |
| get | /v1/m/sessions/workspaces/{ref}/files/stat | sessions:workspace:read | Bearer token | sessions module route (requires sessions:workspace:read) |