Skip to main content
POST
/
api
/
documents
Upload a document
curl --request POST \
  --url https://api.example.com/api/documents \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'file=<string>' \
  --form confirm_ocr=false \
  --form 'subtype=<string>'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "filename": "<string>",
  "mime_type": "<string>",
  "size_bytes": 123,
  "page_count": 123,
  "chunk_count": 123,
  "subtype": "<string>",
  "datahub_urn": "<string>",
  "extraction_warning": "<string>",
  "suggested_summary": "<string>",
  "suggested_domain": "<string>",
  "error": "<string>",
  "s3_key": "<string>",
  "suggested_tags": [
    "<string>"
  ],
  "suggested_glossary_terms": [
    "<string>"
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.nx1cloud.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

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

Body

multipart/form-data
​
file
string
required

Document to ingest (PDF, DOCX, PPTX, MD, TXT, HTML).

​
confirm_ocr
boolean
default:false

Set to true to opt into OCR for scanned PDFs.

​
subtype
string | null

DataHub document type: Runbook, FAQ, Insight, Definition, or Decision. Omit / empty for no subtype (shown as 'None' in DataHub's Type dropdown).

Response

Successful Response

​
id
string<uuid>
required
​
filename
string
required
​
mime_type
string
required
​
size_bytes
integer
required
​
page_count
integer | null
required
​
chunk_count
integer | null
required
​
subtype
string | null
required
​
status
enum<string>
required

Lifecycle status of an ingested document.

Available options:
uploading,
extracting,
ocr_required,
indexed,
failed
​
enrichment_status
enum<string>
required

Crew-driven enrichment lifecycle.

Available options:
pending,
running,
awaiting_review,
confirmed,
failed
​
datahub_urn
string | null
required
​
extraction_warning
string | null
required
​
suggested_summary
string | null
required
​
suggested_domain
string | null
required
​
error
string | null
required
​
s3_key
string | null
required
​
suggested_tags
string[]
​
suggested_glossary_terms
string[]