Desktop

Start a desktop recording session

Creates a new desktop recording session, allocates a request row, and returns the first batch of 30 presigned S3 PUT URLs (covering ~5 minutes of 10-second WAV chunks).

post/v1/desktop/sessions

Request

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

Request body

device_idstring required

Stable UUID generated by the desktop app on first launch.

started_atstring required

ISO-8601 UTC timestamp when the recording started.

titlestring

Optional user-provided recording title.

Example request

{
  "device_id": "d1e2f3a4-b5c6-7890-abcd-ef1234567890",
  "started_at": "2026-04-26T10:00:00Z",
  "title": "Team standup 2026-04-26"
}

Response

Session created.

session_idstring required

The request.id for this session, used in extend/finalize/GET calls and for polling GET /v1/transcriptions/:id.

finalize_urlstring uri required

Changes

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