Skip to main content
POST
Import what you picked

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json

Start an import.

source
enum<string>
required
Available options:
notion,
sharepoint,
google_drive,
onedrive,
confluence
items
ImportPick · object[]
required
Required array length: 1 - 500 elements
subtype
enum<string> | null

DataHub document type for every imported document.

Available options:
Runbook,
FAQ,
Insight,
Definition,
Decision
catalog
boolean
default:true

Add the documents to the shared catalogue (DataHub), as uploads are: anyone who can search it can read their text. Off keeps them private to you.

enrich
boolean
default:false

Have the enrichment crew suggest a summary, tags, terms and a domain. Off by default: any catalogue document can be classified later from its page.

ocr
boolean
default:false

Read scanned PDFs with OCR (slower). Without it a scanned PDF is imported without text.

Response

Successful Response

An import and, on its own page, its items.

id
string<uuid>
required
source
enum<string>
required
Available options:
notion,
sharepoint,
google_drive,
onedrive,
confluence
status
enum<string>
required
Available options:
queued,
running,
completed,
failed
total
integer
required

Files and pages found (folders expanded).

imported
integer
required

New documents, and replaced ones.

skipped
integer
required
failed
integer
required
created_at
string<date-time>
required
error
string | null

Why the whole import stopped.

options
Options · object
finished_at
string<date-time> | null
items
ImportItemResponse · object[]