Get knowledge base

curl --request GET \
  --url https://api.sigmamind.ai/v1/knowledge-bases/{kbId} \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.sigmamind.ai/v1/knowledge-bases/{kbId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sigmamind.ai/v1/knowledge-bases/{kbId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sigmamind.ai/v1/knowledge-bases/{kbId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.sigmamind.ai/v1/knowledge-bases/{kbId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "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"
}

{
  "error": "Bad Request",
  "message": "Invalid request parameters",
  "path": "/v1/knowledge-bases",
  "status": 400,
  "timestamp": "2026-05-14T14:27:22.328Z"
}

{
  "error": "Unauthorized",
  "message": "X-API-Key is missing or invalid",
  "path": "/v1/knowledge-bases",
  "status": 401,
  "timestamp": "2026-05-14T14:27:22.328Z"
}

{
  "error": "Forbidden",
  "message": "Access denied for this resource",
  "path": "/v1/knowledge-bases",
  "status": 403,
  "timestamp": "2026-05-14T14:27:22.328Z"
}

{
  "error": "Not Found",
  "message": "The requested resource was not found",
  "path": "/v1/knowledge-bases",
  "status": 404,
  "timestamp": "2026-05-14T14:27:22.328Z"
}

{
  "error": "Payload Too Large",
  "message": "An uploaded file exceeds the per-file size limit (25 MB).",
  "path": "/v1/knowledge-bases",
  "status": 413,
  "timestamp": "2026-05-14T14:27:22.328Z"
}

{
  "error": "Unsupported Media Type",
  "message": "Uploaded file type is not supported. Allowed: PDF, TXT, HTML, Markdown, DOCX.",
  "path": "/v1/knowledge-bases",
  "status": 415,
  "timestamp": "2026-05-14T14:27:22.328Z"
}

{
  "error": "Internal Server Error",
  "message": "Something went wrong on the server",
  "path": "/v1/knowledge-bases",
  "status": 500,
  "timestamp": "2026-05-14T14:27:22.328Z"
}

GET

knowledge-bases

{kbId}

Get knowledge base

curl --request GET \
  --url https://api.sigmamind.ai/v1/knowledge-bases/{kbId} \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.sigmamind.ai/v1/knowledge-bases/{kbId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sigmamind.ai/v1/knowledge-bases/{kbId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sigmamind.ai/v1/knowledge-bases/{kbId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.sigmamind.ai/v1/knowledge-bases/{kbId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "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"
}

{
  "error": "Bad Request",
  "message": "Invalid request parameters",
  "path": "/v1/knowledge-bases",
  "status": 400,
  "timestamp": "2026-05-14T14:27:22.328Z"
}

{
  "error": "Unauthorized",
  "message": "X-API-Key is missing or invalid",
  "path": "/v1/knowledge-bases",
  "status": 401,
  "timestamp": "2026-05-14T14:27:22.328Z"
}

{
  "error": "Forbidden",
  "message": "Access denied for this resource",
  "path": "/v1/knowledge-bases",
  "status": 403,
  "timestamp": "2026-05-14T14:27:22.328Z"
}

{
  "error": "Not Found",
  "message": "The requested resource was not found",
  "path": "/v1/knowledge-bases",
  "status": 404,
  "timestamp": "2026-05-14T14:27:22.328Z"
}

{
  "error": "Payload Too Large",
  "message": "An uploaded file exceeds the per-file size limit (25 MB).",
  "path": "/v1/knowledge-bases",
  "status": 413,
  "timestamp": "2026-05-14T14:27:22.328Z"
}

{
  "error": "Unsupported Media Type",
  "message": "Uploaded file type is not supported. Allowed: PDF, TXT, HTML, Markdown, DOCX.",
  "path": "/v1/knowledge-bases",
  "status": 415,
  "timestamp": "2026-05-14T14:27:22.328Z"
}

{
  "error": "Internal Server Error",
  "message": "Something went wrong on the server",
  "path": "/v1/knowledge-bases",
  "status": 500,
  "timestamp": "2026-05-14T14:27:22.328Z"
}

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.

Path Parameters

kbId

string

required

Knowledge base id from a create or list response.

Response

The knowledge base.

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.

Show child attributes

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"

⌘I

Calls

Chats

Phone Numbers

Single Prompt Agents

Campaigns

Integrations

Integration Auth

Integration Tools

Test Cases

Batch

Test Runs

Webhooks

QA Rules

QA Issues

Knowledge bases

Get knowledge base

Authorizations

Path Parameters

Response