Create Transaction

Post data using field names to a specific dataset. Data will be processed according to Governance Rules defined in the related dataset (template in The Data Standards Cloud UI). If any data fails when tested against Governance Rules, the entire dataset will be moved into the draft/pending state, and no attached integrations will be run. If no data fails, integrations will be executed as defined in the dataset (template in The Data Standards Cloud UI). This endpoint returns a transactionUuid, which can be used to retrieve the submission status and results. Note: the current implementation allows a max of 1,000 rows per request.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

POST Data to a specific dataset

Post data to a specific dataset. Data will be processed according to Governance Rules defined in the related dataset (template in The Data Standards Cloud UI). If any data fails when tested against Governance Rules, the entire dataset will be moved into the draft/pending state, and no attached integrations will be run. If no data fails, integrations will be executed as defined in the dataset (template in The Data Standards Cloud UI).

This endpoint doesn't support payloads containing headers with duplicated names. In case the template has multiple fields with the same name and the payload has one header with that name, all values will be duplicated for all columns with that name.

This endpoint returns a transactionUuid, which can be used to retrieve the submission status and results.

Note: the current implementation allows a max of 1,000 rows per request.

📘

Notes

The default rate limit is 100 requests per minute, which is shown through the response headers X-RateLimit-Limit and X-RateLimit-Remaining.

API keys and secrets are generated in The Data Standards Cloud UI, and they are given the same permissions as the user who created them. Talk to your CSM for additional information.

Updating data for a specific dataset

Include the Claravine Id field in fields to overwrite a row. By adding a row's CVID value in your rows data, your row will replace the previous row in that template's dataset. You may not add rows to and update in the same request.

📘

Static Fields

Static fields can also be updated through the API. To keep values for types such as random, autonumber, or pattern, resubmit them with your update.

Path Params
string
required
Defaults to datasetUuid

($uuid)

Body Params
json
required
string
required
fields
array of strings
required

An array of field strings

fields*
rows
array of strings
required

A 2D array of rows and field values

rows*
Headers
int32

Number of requests allowed per minute.

int32

Number of requests available in the current minute.

Responses

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json