v32

OpenAPI 3.0.3AGPL-3.0-onlyraw.githubusercontent.com2026-08-0178220333.8 KB
encryption

POST /encryption/unlock-with-passphrase

Unlocks the space with a user-supplied plaintext passphrase (ADR-008 D15).

Routes through the engine unlock operation, which also runs switch-space, search, receive, clipboard gate, and deferred-service recovery. On success the HTTP layer only broadcasts encryption.session_ready.

D14: this endpoint is session-JWT gated (it is NOT in PUBLIC_PATHS) and the handler MUST NOT log the request body — there is intentionally no ?req / passphrase field on any span or tracing event here.

post/encryption/unlock-with-passphrase

Request body

passphrasestring required

Response

Space unlocked

tsinteger required

Server time when the response was built (unix epoch milliseconds).