v1

latestOpenAPI 3.0.02026-08-06132933.0 KB

Datasets

Create an ingestion

Adds a batch of data records to the specified dataset through an ingestion event.

You can include up to 100 records per ingestion event.

The returned ingestionId values can be used with the corresponding ingestion details endpoint to retrieve more information the ingestion event.

post/v1/datasets/{datasetId}/data

Path parameters

datasetIdstring uuid required

Unique identifier for the dataset.

Example:4e1219d8-7fa8-44b7-96c6-a8f2a9cfb0bf

Headers

Content-Typestring required

Must be set to application/json

Request body

recordsRecordsItem[] required

Aray of arbitrary key-value pairs representing a single event, item, or row.

Response

Successful response containing confirmation that the ingestion request was accepted.

requestIdstring

Unique identifier for the request.

statusstring

Indicates the status of the request.

ingestionIdstring uuid

Unique identifier for the ingestion event.

messagestring date-time

Human-readable message describing the outcome of the request (for display/logging; not intended for programmatic parsing).

Example response

{
  "requestId": "b0eac937-c25c-47a5-bb7e-552f6b860458",
  "status": "success",
  "ingestionId": "8bfba187-84f4-41e2-9dd3-bee4bb884205",
  "message": "Data ingestion request accepted"
}