---
title: "Create Knowledge Base"
method: POST
path: "/v1/knowledge"
tags: ["Knowledge"]
---

# Create Knowledge Base

`POST /v1/knowledge`

Create a new knowledge base.

## Headers

- `authorization` string, nullable

## Request body

- KnowledgeBaseCreate — Schema for creating a new knowledge base.
  - `name` string, required — Knowledge base name
  - `description` string, nullable — Knowledge base description
  - `topics` string[], nullable — Topics to monitor via Exa search (legacy format)
  - `topicConfigs` ExaSearchConfigCreate[], nullable — Full Exa search configurations
    - `query` string, required — Main search query
    - `additionalQueries` string[], nullable — Query variations (max 3)
    - `category` 'company' | 'research paper' | 'news' | 'pdf' | 'github' | 'tweet' | 'personal site' | 'financial report' | 'people', nullable — Search category
    - `startPublishedDate` string, nullable — ISO 8601 date for filtering by publish date start
    - `endPublishedDate` string, nullable — ISO 8601 date for filtering by publish date end
  - `sources` string[], nullable — Source URLs to monitor via Exa livecrawl
  - `cadenceSeconds` integer, nullable — Refresh interval in seconds

## Response `201`

Successful Response

- KnowledgeBaseResponse — Schema for knowledge base creation response.
  - `message` string, required — Status message
  - `knowledgeBase` KnowledgeBaseData, required — Schema for knowledge base data.
    - `id` string, required — Knowledge base ID
    - `slug` string, required — Knowledge base slug
    - `name` string, required — Knowledge base name
    - `description` string, nullable — Knowledge base description
    - `organizationSlug` string, required — Organization slug
    - `createdAt` string, date-time, required — Creation timestamp
    - `updatedAt` string, date-time, nullable — Last update timestamp

## 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)