Upload a PDF file to a knowledge base

POST

https://api.smallest.ai/atoms/v1/knowledgebase/:id/items/upload-media

Upload a PDF file to a knowledge base. Only PDF files are accepted (validated by MIME type and extension).

400 is returned for billing/entitlement failures before the file is processed:

"Insufficient credits for KB storage upload." — account lacks upload credits
"KB storage access is not enabled for your account." — plan doesn’t include KB storage

No application-level file size limit is enforced — any proxy or infrastructure limits (e.g. nginx) apply instead.

Upload a PDF file to a knowledge base. Only PDF files are accepted (validated by MIME type and extension). **400 is returned for billing/entitlement failures before the file is processed:** - `"Insufficient credits for KB storage upload."` — account lacks upload credits - `"KB storage access is not enabled for your account."` — plan doesn't include KB storage No application-level file size limit is enforced — any proxy or infrastructure limits (e.g. nginx) apply instead.

Authentication

AuthorizationBearer

API key from the console ApiKey collection, sent as Bearer token. Also accepts session cookies for browser-based auth.

Path parameters

idstringRequired

The ID of the knowledge base

Request

This endpoint expects a multipart form containing a file.

mediafileRequired

Response

Knowledge base item created successfully

statusboolean

Errors

400

Bad Request Error

401

Unauthorized Error

500

Internal Server Error

1	from smallestai import SmallestAI
2
3	client = SmallestAI(
4	token="YOUR_TOKEN_HERE",
5	)
6
7	client.atoms.knowledge_base.upload_a_pdf_file_to_a_knowledge_base(
8	id="id",
9	media="example_media",
10	)