Skip to main content
POST
/
upload
/
multipart
/
{username}
/
{namespace}
/
{datasetName}
/
prepare
Prepare multipart upload
curl --request POST \
  --url https://api.datalinks.com/api/v1/upload/multipart/{username}/{namespace}/{datasetName}/prepare \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "filename": "large-data.csv",
  "size": 73473457
}'
{
  "uploadId": "2~VmxqYXRlRDZWfjJrRWRiZ2FEQXk3dHI4DGhGLygtTmQNXEZPQXFzMVZOZTUgdEdrXCEyNStkQUp3U3Q2RjJqSkV4MFNBOWxJCk0yIHEkfcQ",
  "key": "uploads/data/20240301-143022-uuid.json",
  "partSize": 8388608,
  "presignedUrls": [
    {
      "url": "https://my-data-bucket.s3.amazonaws.com/uploads/data/20240301-143022-uuid.json?partNumber=1&uploadId=..."
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Use a Bearer token for authentication. Submit the token using the Authorization header: Authorization: Bearer <token>.

Path Parameters

​
username
string
required

The username associated with the request.

​
namespace
string
required

Namespace for the dataset.

​
datasetName
string
required

Name of the dataset.

Body

application/json
​
filename
string
required

Name of the file being uploaded

Example:

"large-data.csv"

​
size
integer
required

Size of the file in bytes

Example:

73473457

Response

Multipart upload prepared successfully

​
uploadId
string
required

Unique identifier for the multipart upload session

Example:

"2~VmxqYXRlRDZWfjJrRWRiZ2FEQXk3dHI4DGhGLygtTmQNXEZPQXFzMVZOZTUgdEdrXCEyNStkQUp3U3Q2RjJqSkV4MFNBOWxJCk0yIHEkfcQ"

​
key
string
required

Generated S3 object key

Example:

"uploads/data/20240301-143022-uuid.json"

​
partSize
integer
required

Size of each part in bytes (8MB)

Example:

8388608

​
presignedUrls
object[]
required

Array of presigned URLs for multipart upload

Required array length: 1 - 10000 elements