Skip to main content
POST
Import conversation files into the document library

Authorizations

Authorization
string
header
required

Use Authorization: Bearer <token>. The token is either a user token / OAuth access token, or a service-account API key (cfk_...). A key is valid on every endpoint and acts as its service account, an organization member with per-store permissions. Refused keys answer 403 with Invalid API key., API key revoked., API key expired. or API key disabled..

Path Parameters

project_id
string<uuid>
required

UUID of the project

Body

application/json
local_document_ids
string<uuid>[]
required

Uploaded LocalDocument UUIDs to import.

Maximum array length: 20
collection_id
string<uuid> | null

Optional collection to place the new documents in.

Response

Import completed (skipped files reported per item). A 201 does not mean every file landed: when all of them are skipped, imported_count is 0 and every id appears in skipped, so clients must read skipped rather than treating any 2xx as a full success.

imported_count
integer
documents
object[]
skipped
object[]