Beta module namespace
recording
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 |
|---|---|---|---|---|
| post | /v1/m/recording/ack | recording:notice:read | Bearer token | Records the operator's explicit AC-8 acknowledgement: it opens (or finds) the caller's active recording session and stamps consent. |
| get | /v1/m/recording/config | recording:config:admin | Bearer token | Returns the resolved recording policy (defaults applied). |
| put | /v1/m/recording/config | recording:config:admin | Bearer token | Replaces the tenant's recording policy (admin; self-audited). |
| get | /v1/m/recording/notice | recording:notice:read | Bearer token | Returns the caller's recording posture for this tenant: what is recorded, the consent mode, and whether THIS credential has an acknowledged active session. |
| get | /v1/m/recording/sessions | recording:session:admin | Bearer token | Lists recording sessions (admin). |
| get | /v1/m/recording/sessions/{id} | recording:session:admin | Bearer token | Returns one session's metadata (admin; self-audited). |
| get | /v1/m/recording/sessions/{id}/export | recording:session:admin | Bearer token | Returns the session and its full frame list as either a JSON document (format=json, default) or a plain-text timeline summary (format=summary). |
| get | /v1/m/recording/sessions/{id}/replay | recording:session:admin | Bearer token | Returns the forensic replay of one session: its session header, a page of frames (chain order), and the correlated audit-ledger events of the session's window — reconstruction, not blobs. |
| post | /v1/m/recording/sessions/{id}/seal | recording:session:admin | Bearer token | Closes one ACTIVE session explicitly (admin). |
| post | /v1/m/recording/sessions/{id}/summarize | recording:session:admin | Bearer token | Produces the optional Claude-backed reviewer summary of a session (admin). |
| get | /v1/m/recording/sessions/{id}/unified | recording:session:admin | Bearer token | Returns the combined forensic + operational view of one recording session in a single call: session header, frames (paginated), ledger correlation, chain-verification verdict, and the correlated operational timeline from the sessions module (via the TimelineResolver seam). |
| get | /v1/m/recording/sessions/{id}/verify | recording:session:admin | Bearer token | Recomputes one session's frame chain and re-checks every ledger anchor (open, periodic, seal) against the chain — proves, never trusts. |
| post | /v1/m/recording/sweep | recording:session:admin | Bearer token | Seals every idle ACTIVE session (admin; the lazy-seal safety net for credentials that never came back). |