Register a dataset upload
Register Parquet tables and optionally one ZIP of downloaded files. The response contains a Run Proxy URL for each file and an upload token valid for 24 hours. Existing datasets can omit tables to reuse saved mappings or match all business tables by name. Each upload replaces the complete source, sequence and parallel-set slice. Tables omitted from an explicit table list lose their rows in that slice. Idempotency-Key is optional but recommended; reuse the same key when retrying registration. Without a key, each request creates a new registration subject to normal conflict checks. Category and dataset names are matched case-insensitively. A category name is reused or created within the owning organization. Organization administrator access is required.
curl --request POST 'https://dashboard.sequentum.com/api/v1/dataset-uploads' \
--header 'Authorization: ApiKey {key}' \
--header 'Content-Type: application/json' \
--data '{"datasetId":42,"sourceId":"crm"}'const response = await fetch('https://dashboard.sequentum.com/api/v1/dataset-uploads', {
method: 'POST',
headers: { Authorization: 'ApiKey ' + process.env.SEQUENTUM_API_KEY, 'Content-Type': 'application/json' },
body: JSON.stringify({"datasetId":42,"sourceId":"crm"})
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());import os
import requests
response = requests.post(
'https://dashboard.sequentum.com/api/v1/dataset-uploads',
headers={'Authorization': 'ApiKey ' + os.environ['SEQUENTUM_API_KEY']},
json={"datasetId":42,"sourceId":"crm"},
timeout=60,
)
response.raise_for_status()
print(response.json()){
"uploadId": 123,
"datasetId": 123,
"sourceId": "<string>",
"sequence": 123,
"parallelSet": 123,
"extractedTime": "2023-11-07T05:31:56Z",
"categoryId": 123,
"categoryName": "<string>",
"deadline": "2023-11-07T05:31:56Z",
"status": "<string>",
"error": "<string>",
"files": [
{
"fileId": 123,
"table": "<string>",
"kind": "<string>",
"uploadUrl": "<string>",
"uploaded": true
}
],
"uploadToken": "<string>",
"step": 123,
"totalSteps": 123,
"previewSchema": {
"systemColumnsVersion": 0,
"hasCollectionTable": false,
"hasFileTable": true,
"tables": [
{
"id": "<string>",
"name": "<string>",
"displayName": "<string>",
"parentTableId": "<string>",
"isPrimary": true,
"hasParentId": true,
"columns": [
{
"isFileReference": true,
"name": "<string>",
"sourceName": "<string>",
"type": "<string>",
"contentType": 0,
"isEncrypted": true
}
]
}
],
"warnings": [
"<string>"
]
},
"previewMappings": {
"tables": [
{
"sourceTableId": "<string>",
"targetTable": "<string>",
"columns": {},
"selectSql": "<string>"
}
],
"stagingRetentionDays": 123
},
"previewPending": true
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>"
}Authorizations
Body
Registers a delivery of Parquet tables and an optional ZIP of downloaded files.
Response
OK