Desktop

Register an imported Desktop file

post/v1/desktop/imports

Request

  • Base URL: https://api.quillhub.ai
  • URL: https://api.quillhub.ai/v1/desktop/imports
  • 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

Import accepted against ordinary billing.

request_idstring required
status'TO_TRANSCRIBE' | 'TRANSCRIBING' | 'TO_STRUCTURE' | 'STRUCTURING' | 'COMPLETED' | 'FAILED' required
access_sourcestring required
trial_startedboolean required
trialobject nullable required
replayedboolean required

Changes

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