API

Connect your systems with scoped API keys.

An admin creates server-to-server keys with upload, query or ask scopes, an optional expiry and instant revocation. Two calls and your ERP creates a document and uploads the file; a third searches or asks.

3 SCOPESUPuploadQqueryASKaskSHAShown only once
YOUR SYSTEMS, CONNECTED

Each system with its key — and each key with its scope.

Keys look like ari_…, are stored only as a SHA-256 hash and are shown just once, when created.

ERPERP● upload
Uploads invoices and orders
POST /api/v1/documents
CRMCRM● query
Searches contracts
POST /api/v1/query
PORPortal● ask
Questions with sources
POST /api/v1/ask
KEYari_… key● SHA-256
Shown once
Optional expiry
REVRevoke● Immediate
From Settings
Confirm revoke
LIMLimits● Per person and workspace
With Retry-After
429
A key doesn’t see everything: only documents with no collection or in workspace-wide collections.
Scopes depend on the plan: ask is on Professional and Enterprise.
HOW TO INTEGRATE

From a key to your first document in three calls.

1 · KEYSettings → API Keys

Name, scopes and optional expiry. Copy it — it won’t be shown again.

2 · CREATEThe document

POST /api/v1/documents with type and title.

3 · UPLOADThe file

POST /api/v1/documents/{id}/upload, up to 25 MB.

4 · SEARCH OR ASKWith sources

POST /api/v1/query or /api/v1/ask.

For Search and Ask to find it: files uploaded via the API are indexed on publish or with “Index for Ask”.
TRY IT — SAMPLE CONSOLE

Call the API and see every response.

“Distribuidora Norte” · “ERP ingestion” key · upload, query scopes.

About upload
POST /api/v1/documents · {"type_id": "Invoice", "title": "Invoice F-2026-0042"}
201 CREATED

id: 6b1f… · version 1

X-API-Key: ari_…

Sample data.

SECURE KEYS

Scoped, revocable and never stored in plain text.

01SHA-256 hash

The plain-text key is shown only once.

02Scopes

upload, query and ask, depending on the plan.

03Expiry

Optional, with a date.

04MFA

Creating keys requires MFA for admins.

Usage limits

Per-person values; when exceeded the API returns 429 with Retry-After.

EndpointPer minutePer dayWorkspace / day
/api/v1/query602,00010,000
/api/v1/ask103002,000
/api/v1/ask/deep350500
Upload10100500
HONEST BY DESIGN

What the API does today.

5 key-enabled endpoints

Create, upload, search, ask and deep analysis.

No outbound webhooks

NexDok doesn’t push events to your systems.

Indexing is separate

Uploads are indexed on publish or on request.

Clear errors

422 without echoing values, 429 with Retry-After.

THE KEYS SCREEN

Create, copy and revoke from Settings.

Only owners and admins create keys. Scopes your plan doesn’t include show “Upgrade”.

Create API keyCopy API keyRevokeScopesExpires at
API Keys2 active
ERP INGESTIONuploadquery
CRM SEARCHquery—
PLAN5keys max
UploadQueryAsk · Upgrade
API key created: Copy now — shown once only
A REAL RESPONSE

Ask from your system and get the sources back.

/api/v1/ask answers only from the retrieved context and lists its sources; with no context, it says so without calling the AI.

POST /api/v1/ask · {"question": "What’s the cancellation policy?"}
ANSWER

Cancellations are accepted up to 48 hours before…

SOURCES

document_id · version_id · chunk_index · similarity

ask scope · Professional and Enterprise
Owner or Admin

Creates and revokes keys.

Plan scopes

upload and query; ask on Professional and Enterprise.

HTTPS + X-API-Key

Header on every call.

Indexed documents

For query and ask.

Which system do you want to connect first?

Tell us your ERP, CRM or portal. We’ll help with the integration.

Contact us