---
title: "Create Knowledge Base"
method: POST
path: "/external/kb"
tags: ["knowledgebase"]
---

# Create Knowledge Base

`POST /external/kb`

Creates a new non-deterministic knowledge base. Rate limit: 10 requests per hour per workspace. File size limit: 2 MB per file, 5 MB total. Maximum 10 files and 20 URLs per request.

## Headers

- `X-API-KEY` string, required

## Response `200`

Knowledge base created successfully.

- object
  - `message` string
  - `kb_id` string
  - `processing_status` string
  - `files_queued` integer

## Other responses

- `400` — Bad Request - Invalid parameters or file size exceeded.
- `401` — Unauthorized - Invalid or missing API key.
- `429` — Rate limit exceeded - Maximum 10 requests per hour.

---

[API](https://skmtc.net/ringg/apis/ringg-ai-api-documentation.md) · [All operations](https://skmtc.net/ringg/apis/ringg-ai-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringg/ringg-ai-api-documentation/versions/00b614a7714c/schema)