Sign in

v1

latestOpenAPI 3.0.0Cognigy Proprietary License2026-07-2239524.1 MB
Knowledge Sources

Create a Knowledge Source

Creates a Knowledge Source in a Knowledge Store. You define the source metadata and type—no file is uploaded. Use this method for manual sources, URL sources (for web scraping), or when creating the source first and ingesting content later (pdf, txt, ctxt).

post/v2.0/knowledgestores/{knowledgeStoreId}/sources

Path parameters

knowledgeStoreIdstring required

The Id of the KnowledgeStore

Headers

Accept'application/json' | 'application/hal+json' | 'application/xml' | 'text/xml' | 'text/csv'

The Accept header specifies the media type that the client expects in the response. Available options: application/json, application/hal+json, application/xml, text/xml, text/csv. The default value is application/json.

Request body

OR

Example request

{
  "name": "mysource",
  "description": "mysource description",
  "metaData": {
    "tags": [
      "tag1"
    ]
  },
  "url": "https://www.some-article.com"
}

Response

Returns KnowledgeSource metadata object.

Example response

{
  "knowledgeSource": {
    "name": "mysource",
    "description": "mysource description",
    "metaData": {
      "tags": [
        "tag1"
      ]
    },
    "data": {
      "_id": "x4xU6hMntv23p",
      "sys_CreatedAt": "2019-12-16T11:40:45.7212",
      "sys_UpdatedAt": "2025-10-01T07:46:04.5932",
      "Type": "FAQ"
    },
    "createdAt": 1694518620,
    "lastChanged": 1694518620
  }
}