Desktop

Register an uploaded desktop recording for transcription

Call this AFTER successfully PUT-ing the WAV to the URL returned by /presign. Inserts a request row in TO_TRANSCRIBE state with a 30-day presigned GET URL in audio_url; the transcriber worker picks it up directly (no DOWNLOADING phase).

post/v1/desktop/recordings

Request

  • Base URL: https://api.quillhub.ai
  • URL: https://api.quillhub.ai/v1/desktop/recordings
  • Auth: HTTP bearer

Request body

device_idstring required

Stable UUID generated by the desktop app on first launch.

keystring required

S3 key returned by the /presign call. Server validates it belongs to the caller's prefix.

filenamestring required
mime_typestring nullable
size_bytesinteger required
started_atstring required

ISO-8601 UTC timestamp when the recording started.

duration_msinteger nullable
languagestring nullable
titlestring nullable
kind'meeting' | 'dictation' nullable

Optional categorisation. 'dictation' for widget voice notes (so the desktop dashboard can filter them), 'meeting' (or absent) for everything else.

workspace_idinteger nullable

Workspace to route this recording into. When absent, a DB trigger falls back to the caller's default workspace. Server verifies the caller is a member of the target workspace.

project_idinteger nullable

Project within the target workspace. NULL = Inbox. Server verifies the project belongs to the workspace.

Example request

{
  "mime_type": "audio/wav",
  "kind": "dictation"
}

Response

Recording registered.

request_idstring required
status'TO_TRANSCRIBE' required

Changes

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