Skip to main content
POST
/
v1
/
knowledge-bases
Create knowledge base
curl --request POST \
  --url https://api.sigmamind.ai/v1/knowledge-bases \
  --header 'Content-Type: multipart/form-data' \
  --header 'X-API-Key: <api-key>' \
  --form 'knowledge_base_files=<string>' \
  --form knowledge_base_files.items='@example-file'
{
  "kbId": "kb_6sbr3tbMX757M0VD",
  "name": "Support FAQs",
  "files": [
    {
      "documentId": "doc_a1b2c3d4e5f67890",
      "type": "url",
      "content": "https://docs.example.com/guide"
    }
  ],
  "createdAt": "2026-05-06T11:15:02.073Z",
  "updatedAt": "2026-05-06T11:15:02.073Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.sigmamind.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-API-Key
string
header
required

Authenticate every request by passing your API key in the X-API-Key header. To get your key, go to Dashboard → API Keys and create or copy your Production API key.

Query Parameters

​
knowledge_base_name
string
required

Name of the new knowledge base. Names do not need to be unique.

​
knowledge_base_texts
string

Optional. Send as one form field whose value is a JSON array string. Example: knowledge_base_texts=["Hello",{"title":"Q","text":"A"}]. Plain strings become text sources; objects may use title and/or text.

​
knowledge_base_urls
string

Optional. Send as one form field whose value is a JSON array of URL strings (not native repeated fields). Example: knowledge_base_urls=["https://example.com/docs"]. Each entry must be a URL string.

Body

multipart/form-data
​
knowledge_base_files
file[]

Optional. Attach one or more files using the same field name repeated. Allowed file types: PDF, TXT, HTML, Markdown, DOCX. Max file size - 25 MB

Response

Created.

A knowledge base and its sources.

​
kbId
string
required

Use this id in the URL when fetching, updating, or deleting this knowledge base.

Required string length: 1 - 64
Example:

"kb_6sbr3tbMX757M0VD"

​
name
string
required

Knowledge base name

Maximum string length: 512
Example:

"Support FAQs"

​
files
object[]
required

Ordered sources; each item has documentId, type, and content.

​
createdAt
string<date-time>
required

When the knowledge base was created.

Example:

"2026-05-06T11:15:02.073Z"

​
updatedAt
string<date-time>
required

When the knowledge base or its sources were last changed.

Example:

"2026-05-06T11:15:02.073Z"