Skip to main content
POST
/
v2.0
/
knowledgestores
/
{knowledgeStoreId}
/
sources
/
upload
Upload a file to create a new KnowledgeSource
curl --request POST \
  --url 'https://api-trial.cognigy.ai/new/v2.0/knowledgestores/{knowledgeStoreId}/sources/upload?api_key=' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --header 'X-API-Key: <api-key>' \
  --form 'tags=<string>' \
  --form file='@example-file'
{
  "_id": "<string>",
  "status": "queued",
  "type": "trainIntents",
  "parameters": {},
  "lastChangedAt": 1594243850,
  "lastCreatedAt": 1594243850,
  "currentStep": 0,
  "totalStep": 100
}

Authorizations

​
X-API-Key
string
header
required

Supply the API Key in the HTTP-Header

​
api_key
string
query
required

Supply the API Key in the Url-Query

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Headers

​
Accept
enum<string>

The default media type is application/hal+json. Use application/json for pure data results.

Available options:
application/json,
application/hal+json,
application/xml,
text/xml,
text/csv

Path Parameters

​
knowledgeStoreId
string
required

The Id of the KnowledgeStore

Required string length: 24

Body

multipart/form-data
​
tags
string

A comma separated list of tags for the KnowledgeSource

​
file
file

Response

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

​
_id
string
Required string length: 24
​
status
enum<string>

The status of the task

Available options:
queued,
active,
done,
cancelling,
cancelled,
error
Example:

"queued"

​
type
string
Example:

"trainIntents"

​
parameters
object
​
lastChangedAt
number
Example:

1594243850

​
lastCreatedAt
number
Example:

1594243850

​
currentStep
integer
Example:

0

​
totalStep
integer
Example:

100