curl --request POST \
--url https://api.datalinks.com/api/v1/ingest/{namespace}/{datasetName} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"data": [
{
"name": "Braveheart",
"year": 1995,
"budget": 72000000,
"director": "Mel Gibson"
},
{
"name": "Argo",
"year": 2012,
"budget": 44500000,
"director": "Ben Affleck"
},
{
"name": "A Quiet Place",
"year": 2018,
"budget": 17000000,
"director": "John Krasinski"
},
{
"name": "Dances with Wolves",
"year": 1990,
"budget": 22000000,
"director": "Kevin Costner"
},
{
"name": "Unforgiven",
"year": 1992,
"budget": 14000000,
"director": "Clint Eastwood"
},
{
"name": "The Postman",
"year": 1997,
"budget": 80000000,
"director": "Kevin Costner"
}
],
"link": {
"ExactMatch": null
}
}
'{
"indexed": 42
}{
"error_code": "UNAUTHORIZED",
"message": "Missing authentication token",
"error_message": "",
"sub_errors": [
{
"code": "<string>",
"message": "<string>"
}
]
}ingest
Ingest data
Load data into the specified dataset.
POST
/
ingest
/
{namespace}
/
{datasetName}
curl --request POST \
--url https://api.datalinks.com/api/v1/ingest/{namespace}/{datasetName} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"data": [
{
"name": "Braveheart",
"year": 1995,
"budget": 72000000,
"director": "Mel Gibson"
},
{
"name": "Argo",
"year": 2012,
"budget": 44500000,
"director": "Ben Affleck"
},
{
"name": "A Quiet Place",
"year": 2018,
"budget": 17000000,
"director": "John Krasinski"
},
{
"name": "Dances with Wolves",
"year": 1990,
"budget": 22000000,
"director": "Kevin Costner"
},
{
"name": "Unforgiven",
"year": 1992,
"budget": 14000000,
"director": "Clint Eastwood"
},
{
"name": "The Postman",
"year": 1997,
"budget": 80000000,
"director": "Kevin Costner"
}
],
"link": {
"ExactMatch": null
}
}
'{
"indexed": 42
}{
"error_code": "UNAUTHORIZED",
"message": "Missing authentication token",
"error_message": "",
"sub_errors": [
{
"code": "<string>",
"message": "<string>"
}
]
}Authorizations
bearerAuthopenId
Use a Bearer token for authentication. Submit the token using the Authorization
header: Authorization: Bearer <token>.
Path Parameters
Namespace for the dataset.
Name of the dataset.
Body
application/json
Show child attributes
Show child attributes
Show child attributes
Show child attributes
A description of the dataset to help the AI system understand the context.
Maximum string length:
10000Example:
"Employee dataset containing demographics and compensation."
A schema definition mapping field names to descriptions, to guide the AI system in structuring the extracted data.
Show child attributes
Show child attributes
Example:
{
"id": "unique employee identifier",
"name": "full employee name",
"age": "employee age in years",
"department": "work department",
"salary": "annual salary in USD"
}
Additional instructions to guide the AI system during ingestion.
Response
Returns the ingestion result.
Number of records indexed by this request.
Example:
42