v56

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-05311409871.8 KB
v1
onboarding
onboarding
brain-dump

Finalize Brain Dump

Close out a take: assemble, scan, store, transcribe.

Extraction and greeting generation continue in the background after this responds — the preparing step polls /status until greeting_ready. Idempotent per recording_id — a client that retries after a timeout gets the stored result rather than a second transcription.

post/api/onboarding/brain-dump/finalize

Request body

recording_idstring required
input_mode'voice' | 'typed' | 'skipped'
duration_secsnumber nullable
mime_typestring nullable
textstring nullable

Response

Successful Response

status'recording_uploaded' | 'transcribing' | 'transcribed' | 'extracting' | 'completed' | 'failed' required
input_mode'voice' | 'typed' | 'skipped' required
transcript_previewstring nullable
error_codestring nullable