v1
onboarding
onboarding
brain-dump

Finalize Brain Dump

Changed on

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

  • The document declares no server URL.
  • Auth
    HTTP bearer

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
error_reasonstring nullable
transcript_wordsinteger nullable

Changes

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status