Sign in

v1

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

Create a Knowledge Source from a File

Creates a Knowledge Source in the Knowledge Store by uploading a file and asynchronously ingesting its content. Supported file formats pdf, txt, ctxt.

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

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.

Response

Successfully uploaded the file and created a Task to process it.

_idstring
status'queued' | 'active' | 'done' | 'cancelling' | 'cancelled' | 'error'

The status of the task

typestring
parametersobject
lastChangedAtnumber
lastCreatedAtnumber
currentStepinteger
totalStepinteger

Example response

{
  "status": "queued",
  "type": "trainIntents",
  "lastChangedAt": 1594243850,
  "lastCreatedAt": 1594243850,
  "totalStep": 100
}