Ai knowledge Sources

Lists all knowledge sources for a chatbot

get

Required Permission: chatbots.knowledge-source.list

Resource: chatbots/:chatbotId

Authorizations

x-chatcaptain-key

x-chatcaptain-keystringRequired

Path parameters

chatbotIdstringRequired

The ID of the chatbot.

Query parameters

pageTokenstringOptional

The date after which to filter sources. Only sources created after this date will be fetched.

Example: 2025-09-29T07:08:00Z

limitnumberOptional

The limit for how many sources should be fetched.

Responses

200

List of all knowledge sources.

application/json

errorstringOptional

Optional error message

pageTokenstringRequired

The date of the latest fetched source.

Example: 2025-09-29T07:08:00Z

403

Insufficient permissions.

get

/v1/chatbots/{chatbotId}/ai/knowledge/sources

HTTPcURLJavaScriptPython

GET /v1/chatbots/{chatbotId}/ai/knowledge/sources HTTP/1.1
Host: api.chatcaptain.com
x-chatcaptain-key: YOUR_API_KEY
Accept: */*

{
  "sources": [
    {
      "id": "bWDWW8q3ks31wQsc6xiD",
      "source": "https://www.example-company.com/faq",
      "groupIds": [
        "meEcrKgnNHuBqDFXc3Pv"
      ],
      "enabled": true,
      "isIndexing": false,
      "created": "2025-09-29T10:00:00Z",
      "type": 0,
      "status": 2,
      "name": "FAQ page",
      "errorReason": "Source not found.",
      "metadata": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ],
  "error": "text",
  "pageToken": "2025-09-29T07:08:00Z"
}

Deletes a batch of knowledge sources.

delete

Required Permission: chatbots.knowledge-source.delete

Resource: chatbots/:chatbotId

Authorizations

x-chatcaptain-key

x-chatcaptain-keystringRequired

Path parameters

chatbotIdstringRequired

The ID of the chatbot.

Body

application/json

sourceIdsstring[]Required

A list of deleted source Id's.

Example: 10ß443d31264etg

Responses

200

Deletion result.

application/json

errorstringOptional

Optional error message.

deletedbooleanRequired

Indicates whether the deletion succeeded.

Example: true

403

Insufficient permissions.

delete

/v1/chatbots/{chatbotId}/ai/knowledge/sources

HTTPcURLJavaScriptPython

DELETE /v1/chatbots/{chatbotId}/ai/knowledge/sources HTTP/1.1
Host: api.chatcaptain.com
x-chatcaptain-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 32

{
  "sourceIds": "10ß443d31264etg"
}

{
  "error": "text",
  "deleted": true
}

Retrieves a specific knowledge source

get

Required Permission: chatbots.knowledge-source.get

Resource: chatbots/:chatbotId

Authorizations

x-chatcaptain-key

x-chatcaptain-keystringRequired

Path parameters

chatbotIdstringRequired

The ID of the chatbot.

sourceIdstringRequired

The ID of the knowledge source to retrieve.

Responses

200

Knowledge source details.

application/json

errorstringOptional

Optional error message

chunksContentstring[]Required

Content of the source split into chunks.

Example: ["Some Paragraph.","Another Paragraph"]

403

Insufficient permissions.

get

/v1/chatbots/{chatbotId}/ai/knowledge/sources/{sourceId}

HTTPcURLJavaScriptPython

GET /v1/chatbots/{chatbotId}/ai/knowledge/sources/{sourceId} HTTP/1.1
Host: api.chatcaptain.com
x-chatcaptain-key: YOUR_API_KEY
Accept: */*

{
  "source": {
    "id": "bWDWW8q3ks31wQsc6xiD",
    "source": "https://www.example-company.com/faq",
    "groupIds": [
      "meEcrKgnNHuBqDFXc3Pv"
    ],
    "enabled": true,
    "isIndexing": false,
    "created": "2025-09-29T10:00:00Z",
    "type": 0,
    "status": 2,
    "name": "FAQ page",
    "errorReason": "Source not found.",
    "metadata": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    }
  },
  "error": "text",
  "chunksContent": [
    "Some Paragraph.",
    "Another Paragraph"
  ]
}

Uploads knowledge source files.

post

Required Permission: chatbots.knowledge-source.create

Resource: chatbots/:chatbotId

Authorizations

x-chatcaptain-key

x-chatcaptain-keystringRequired

Path parameters

chatbotIdstringRequired

The ID of the chatbot.

Body

multipart/form-data

filesstring · binary[]Required

Files to be uploaded as knowledge sources.

Responses

200

Upload result.

application/json

successbooleanOptional

Indicates whether the upload was successful.

Example: true

errorstringOptional

Optional error message.

201Success

application/json

403

Insufficient permissions.

post

/v1/chatbots/{chatbotId}/ai/knowledge/sources/upload

HTTPcURLJavaScriptPython

POST /v1/chatbots/{chatbotId}/ai/knowledge/sources/upload HTTP/1.1
Host: api.chatcaptain.com
x-chatcaptain-key: YOUR_API_KEY
Content-Type: multipart/form-data
Accept: */*
Content-Length: 20

{
  "files": [
    "binary"
  ]
}

{
  "success": true,
  "error": "text"
}