Documents & Uploads - Hexel Studio

Upload documents directly when you have one-off files — a PDF policy handbook, an internal wiki export, a set of FAQs — that you want agents to search. Unlike connectors (which sync a live data source on a schedule), document uploads are a manual, point-in-time action. If the file rarely changes or you just need it indexed once, this is the fastest path. Documents are files you add directly to a knowledge store. The platform parses, chunks, and embeds them automatically so content becomes searchable without preprocessing.

Supported formats

Format	Notes
PDF	Text-extractable only; image-only PDFs will not chunk.
DOCX	Microsoft Word (`.docx`).
TXT	Plain text.
MD	Markdown.
HTML	Web pages and exported HTML.
JSON	Structured data; flattened for chunking.
CSV	Tabular data; rows become chunks.

Only the formats above are supported. DOC, XML, and XLSX are not accepted. Maximum file size: 100 MB.

How it works

Upload a document

curl -X POST https://api.hexelstudio.com/data/v1/knowledge/YOUR_STORE_ID/documents \
  -H "Authorization: Bearer $TOKEN" \
  -F "file=@handbook.pdf"

Response

string

Unique document identifier.

string

Original filename.

integer

File size in bytes.

string

Processing status (e.g., processing, completed, failed).

string

ISO 8601 upload timestamp.

List documents

curl "https://api.hexelstudio.com/data/v1/knowledge/YOUR_STORE_ID/documents?page=1&page_size=20" \
  -H "Authorization: Bearer $TOKEN"

Delete a document

curl -X DELETE https://api.hexelstudio.com/data/v1/knowledge/YOUR_STORE_ID/documents/YOUR_DOCUMENT_ID \
  -H "Authorization: Bearer $TOKEN"

Deleting a document removes its chunks from the knowledge store. Search results will no longer include content from that file.

Errors

`code`	HTTP	When
`VALIDATION`	400	Unsupported format, or the file exceeds 100 MB.
`AUTH.PERMISSION_DENIED`	403	Missing `data-platform:knowledge:write`.
`RESOURCE.NOT_FOUND`	404	The target knowledge store or document doesn’t exist.

Security

Concern	Detail
Upload permission	`data-platform:knowledge:write` is required to upload, delete, or manage documents.
Read access	Documents inherit the scope of their knowledge store. Any agent with `data-platform:knowledge:read` on the store can retrieve their content via search.
Text extraction	Content must be text-extractable. Image-only PDFs or encrypted files will not index correctly.
Sensitive data	Do not upload secrets, credentials, or data you cannot share with all agents that have read access to the store.

Rate limits

10,000 requests per organization per hour. Maximum file size: 100 MB.

Common errors

Code	Meaning
`400`	Unsupported file format or missing file.
`413`	File exceeds 100 MB limit.
`404`	Knowledge store not found.
`429`	Rate limit exceeded.

Processing time

Small text files process in seconds. Large PDFs (50+ MB) may take several minutes. Poll the document status or use the Syncs view to monitor progress.

Knowledge Stores

Where uploaded documents live.

Connectors

Automate ingestion from S3.

Syncs

Track ingestion runs.

Data Platform Overview

The full data model.

Next steps

Continue to Syncs.

​Supported formats

​How it works

​Upload a document

​Response

​List documents

​Delete a document

​Errors

​Security

​Rate limits

​Related pages

Knowledge Stores

Connectors

Syncs

Data Platform Overview

​Next steps

Supported formats

How it works

Upload a document

Response

List documents

Delete a document

Errors

Security

Rate limits

Related pages

Next steps