---
title: "Register an imported Desktop file"
method: POST
path: "/v1/desktop/imports"
tags: ["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

- object
  - `device_id` string, required: Stable UUID generated by the desktop app on first launch.
  - `key` string, required: S3 key returned by the /presign call. Server validates it belongs to the caller's prefix.
  - `filename` string, required
  - `mime_type` string, nullable
  - `size_bytes` integer, required
  - `started_at` string, required: ISO-8601 UTC timestamp when the recording started.
  - `duration_ms` integer, nullable
  - `language` string, nullable
  - `title` string, 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_id` integer, 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_id` integer, nullable: Project within the target workspace. NULL = Inbox. Server verifies the project belongs to the workspace.

## Response `201`

Import accepted against ordinary billing.

- object
  - `request_id` string, required
  - `status` 'TO_TRANSCRIBE' | 'TRANSCRIBING' | 'TO_STRUCTURE' | 'STRUCTURING' | 'COMPLETED' | 'FAILED', required
  - `access_source` string, required
  - `trial_started` boolean, required
  - `trial` object, nullable, required
  - `replayed` boolean, required

## Other responses

- `401`: Unauthenticated.
- `402`: No ordinary minutes or subscription.

---

[API](https://skmtc.dev/quillhub/apis/quillhub-public-api.md) · [All operations](https://skmtc.dev/quillhub/apis/quillhub-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/quillhub/apis/quillhub-public-api/revisions/5bd42ee9d967?raw)