---
title: "Upload Files"
method: POST
path: "/v1/knowledge/{kb_slug}"
tags: ["Knowledge"]
---

# Upload Files

`POST /v1/knowledge/{kb_slug}`

Upload files to a knowledge base.

## Path parameters

- `kb_slug` string, required

## Query parameters

- `force` boolean — Allow uploading duplicate content

## Headers

- `authorization` string, nullable

## Response `201`

Successful Response

- FileUploadResponse — Schema for file upload response.
  - `message` string, required — Status message
  - `totalFiles` integer, required — Total files processed
  - `successCount` integer, required — Number of successful uploads
  - `successful` FileUploadResult[], required — Successfully uploaded files
    - `filename` string, required — R2 storage filename
    - `name` string, required — Display name
    - `size` integer, required — File size in bytes
    - `mimeType` string, nullable — MIME type
  - `failed` object[], nullable — Failed uploads
  - `knowledgeBaseId` string, required — Knowledge base ID

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/chonkie/apis/chonkie-api.md) · [All operations](https://skmtc.dev/chonkie/apis/chonkie-api/llms.txt) · [OpenAPI document](https://skmtc.dev/chonkie/apis/chonkie-api/revisions/f40f036f941c?raw)