Upload a knowledge base file for an agent

POST

/api/knowledge-base/{agentId}/upload

Uploads a document (PDF, Word .docx, plain text, or Markdown) to the agent's knowledge base. The file is stored, then text is extracted, chunked, and embedded asynchronously in the background; processing status is reflected on the returned file record over time. Enabling occurs automatically once a file is processed.

Request

Authorization

API Key

Add parameter in header

X-API-Key

Example:

X-API-Key: ********************

Path Params

Body Params multipart/form-dataRequired

Responses

🟢200

application/json

File accepted and stored. Background processing (extraction, chunking, embedding) continues asynchronously.

Bodyapplication/json

🟠400

🟠401

🟠404

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.snakk.ai/api/knowledge-base//upload' \
--header 'X-API-Key: <api-key>' \
--form 'file=@""'

Response Example

200 - Success

{
    "success": true,
    "file": {
        "id": "6f0c1e2a-3b4c-4d5e-8f90-123456789abc",
        "agent_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "tenant_id": "11111111-2222-3333-4444-555555555555",
        "filename": "faq.pdf",
        "file_type": "pdf",
        "file_size": 482190,
        "storage_path": "knowledge-base/11111111-2222-3333-4444-555555555555/a1b2c3d4-e5f6-7890-abcd-ef1234567890/1718900000000-faq.pdf",
        "processed": false,
        "created_at": "2026-06-20T10:00:00.000Z"
    }
}

Modified at 2026-07-08 19:01:40

List knowledge base files for an agent

Delete a knowledge base file