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

# Create Knowledge Base

`POST /kb/v1/knowledge-bases`

Create Knowledge Base

## Request body

- object
  - `title` string, required — A descriptive and human-readable name for the knowledge base
  - `description` string
  - `docs` object[] — Here you can upload URLs
    - `type` 'url'
    - `payload` object — Here you can upload URLs
      - `urls_to_include` KnowledgeBaseUrl[]
        - `url` string, uri — This is the URL of the Knowledge Base.
        - `subpaths_only` boolean — If subpaths_only is enabled, the crawler only processes URLs that are subpaths of the parent URL, ignoring links outside the specified path hierarchy.
        - `recursive` boolean — If recursive is enabled, the crawler recursively scrapes all URLs found on the page, including links to external domains.
      - `urls_to_exclude` KnowledgeBaseUrl[]
        - `url` string, uri — This is the URL of the Knowledge Base.
        - `subpaths_only` boolean — If subpaths_only is enabled, the crawler only processes URLs that are subpaths of the parent URL, ignoring links outside the specified path hierarchy.
        - `recursive` boolean — If recursive is enabled, the crawler recursively scrapes all URLs found on the page, including links to external domains.
  - `files` object[]
    - `id` string
  - `retrain_frequency_minutes` integer — Automatic retrain interval in minutes. Set retrain_frequency_minutes = 0 to disable automatic retraining. Allowed values: multiples of 60

## Response `201`

Knowledge Base created successfully

---

[API](https://skmtc.dev/interactly/apis/interactly-api.md) · [All operations](https://skmtc.dev/interactly/apis/interactly-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/interactly/interactly-api/revisions/8a408fde89f6/schema)