AletheiaVoice

Register an in-product Aletheia voice session (DARK)

DARK (MNE-1944): gated fail-closed by an R2 flag + allowlist, zero customer exposure until promoted. Mints an audience-scoped, short-lived voice_grant_token (audience:"in_product") and populates the aletheia-voice per-call stash BEFORE the browser can dial Retell (register-before-dial), so a spoken turn authenticates to the governed runtime without replaying any customer or deck credential. When the flag is absent, the caller is unauthenticated, or the caller is not allowlisted, the endpoint returns an identical opaque 404 ("feature not present") and mints nothing — there is no oracle that the endpoint or a caller's allowlist status exists. Cookie/bearer-authed like any other customer route (not an /internal/* machine-auth surface); registered on the public spec so preDispatchAuthGate can classify it (issue #1519).

post/aletheia/voice/register

Request

  • Base URL: https://api.mnemom.ai/v1
  • URL: https://api.mnemom.ai/v1/aletheia/voice/register
  • Auth: API key in cookie mnemom_session

Request body

contextstring

Optional in-product grounding/context text (KB/page context). Capped server-side. Context text ONLY — never a customer or deck credential.

Response

Voice session registered. Returns the Retell web-call access token + call id for the browser SDK (the browser dials only after this response).

access_tokenstring required

Retell web-call access token.

call_idstring required

Retell call id the minted token is bound to.

Changes

No recorded changes to this operation across all 1 revision of this API.