Skip to main content
POST
/
api
/
v1
/
data-sources
Create a new data source
curl --request POST \
  --url https://api.getdecisional.ai/api/v1/data-sources \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: multipart/form-data' \
  --form file='@example-file' \
  --form 'data={"name":"Annual Report 2023","type":"file","notes":{"category":"financial"},"knowledge_engine_id":"kng_abc123xyz789"}'
{
  "id": "ds_abc123xyz789",
  "name": "Annual Report 2023",
  "type": "file",
  "status": "processed",
  "notes": {
    "category": "financial"
  },
  "knowledge_engine_id": "kng_abc123xyz789",
  "created_at": 1679644800
}

Authorizations

​
Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Body

multipart/form-data
​
file
file
required

The file to upload

​
data
string
required

JSON string containing data source metadata.

Example:

{
  "name": "Annual Report 2023",
  "type": "file",
  "knowledge_engine_id": "kng_abc123xyz789"
}
Example:

"{\"name\":\"Annual Report 2023\",\"type\":\"file\",\"notes\":{\"category\":\"financial\"},\"knowledge_engine_id\":\"kng_abc123xyz789\"}"

Response

Data source created successfully

​
id
string

Unique identifier for the data source

Example:

"ds_abc123xyz789"

​
name
string

Name of the data source

Example:

"Annual Report 2023"

​
type
enum<string>

Type of the data source

Available options:
file,
ticket
Example:

"file"

​
status
enum<string>

Current status of the data source

Available options:
processing,
processed
Example:

"processed"

​
notes
object

Custom attributes and fields

Example:
{ "category": "financial" }
​
knowledge_engine_id
string

ID of the knowledge engine this data source belongs to

Example:

"kng_abc123xyz789"

​
created_at
integer<int64>

Unix timestamp when this entity was created

Example:

1679644800