SIsigmamind
Knowledge bases

Update knowledge base

Updates a knowledge base by adding new sources and/or modifying its name. Supported file types include PDF, TXT, HTML, Markdown, and DOCX. Maximum file size is 25 MB.

patch/v1/knowledge-bases/{kbId}

Request

  • Base URL
    https://api.sigmamind.ai
  • Auth
    API key in header X-API-Key

Path parameters

kbIdstring required

Knowledge base id to change.

Query parameters

knowledge_base_namestring

New name, if you want to rename. Names do not need to be unique.

knowledge_base_textsstring

Optional new text sources. Send as one form field whose value is a JSON array string. Example: knowledge_base_texts=["Hello",{"title":"Q","text":"A"}].

knowledge_base_urlsstring

Optional new URL sources. 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"].

Request body multipart/form-data

knowledge_base_filesstring[]

Optional files, field may be repeated. Allowed file types: PDF, TXT, HTML, Markdown, DOCX. Max file size - 25 MB

Response

Updated knowledge base.

kbIdstring required

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

namestring required

Knowledge base name

createdAtstring date-time required

When the knowledge base was created.

updatedAtstring date-time required

When the knowledge base or its sources were last changed.

Example response

{
  "kbId": "kb_6sbr3tbMX757M0VD",
  "name": "Support FAQs",
  "files": [
    {
      "documentId": "doc_a1b2c3d4e5f67890",
      "type": "url",
      "content": "https://docs.example.com/guide"
    }
  ],
  "createdAt": "2026-05-06T16:45:02.073127+05:30",
  "updatedAt": "2026-05-06T16:45:02.073127+05:30"
}

Changes

No recorded changes to this operation across all 3 revisions of this API.