Desktop

Finalise a dictation captured live via Gladia

Takes a transcript already produced by Gladia (in AssemblyAI shape) and a previously-uploaded WAV key. Inserts a request row in TO_STRUCTURE state with kind='dictation'; the structurer will pick it up and run the light path. Skips the AssemblyAI transcriber entirely.

post/v1/dictation/finalize

Request

  • Base URL: https://api.quillhub.ai
  • URL: https://api.quillhub.ai/v1/dictation/finalize
  • Auth: HTTP bearer

Request body

device_idstring required
keystring required

S3 key returned by /v1/desktop/recordings/presign. Must live under the caller's uploads/<userId>/ prefix.

filenamestring required
mime_typestring nullable
size_bytesinteger required
started_atstring required

ISO-8601 UTC timestamp.

duration_msinteger required
poll_tokenstring

Signed token returned by POST /v1/dictation/live. Required for trial-funded dictation.

languagestring nullable
workspace_idinteger nullable

Workspace to route this dictation into. When absent, a DB trigger falls back to the caller's default workspace — the entitlement gate resolves rights against that same effective value.

Example request

{
  "mime_type": "audio/wav"
}

Response

Row created in TO_STRUCTURE.

request_idstring required
status'TO_STRUCTURE' required

Changes

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