Data8 Logo

Data8 Administration & Batch Data Cleansing API

Manage your Data8 account, submit data to batch data cleansing jobs and retrieve the results

Jobs are submitted to workflows that are built for you by the Data8 Production Team to your specifications, and the details of the data to be provided to each workflow and generated by it will be documented by them.

If you do not already have a workflow available to submit jobs to, please get in touch with your account manager to discuss your requirements.

All requests must be authenticated using an Authorization: Bearer header, with the bearer token being obtained from the Data8 OAuth token server at https://auth.data-8.co.uk/connect/token.

/Dataset/{name}/data

Uploads records to an input dataset

HTTP Method: PATCH

Operation Id: Dataset_UploadBlock

The dataset given by the name parameter must be an incomplete input dataset. If the dataset has already been completed, or if it is an output dataset, a 400 error will be produced.

Multiple uploads can be made to the same dataset. Each block of records must be identified by a unique block number. If the same block number is used for multiple uploads to the same dataset, the previously uploaded records will be overwritten.

Depending on the job the records will be submitted to, the order of the records may be important. Records will be processed in ascending block number order, then the order in which they were submitted within that block.

Split large uploads into multiple blocks. Up to 1,000 records can be supplied in each block.

Parameters

The name of the dataset to upload the records to

Request Body

The details of the records to upload

Example Value Schema
{
	"blockNumber": 0,
	"records": []
}
Responses

The data has been uploaded to the dataset correctly

A validation error in the record block has occurred

Example Value Schema
{
	"errors": {},
	"type": "string",
	"title": "string",
	"status": 0,
	"detail": "string",
	"instance": "string",
	"errors": {}
}

The requested dataset does not exist

An error has occurred. This application may no longer respond until reloaded. Reload 🗙