Skip to content

Create chunked upload session

POST
/v3/uploads
curl --request POST \
--url https://api.cardio.ai/v3/uploads \
--header 'Content-Type: application/json' \
--header 'X-Api-Token: <X-Api-Token>' \
--data '{ "total_size": 1, "hash_sum": "example" }'

Creates a new session for uploading a file in chunks.

Chunked upload request.

Media type application/json

Request payload for initializing a chunked upload.

object
total_size
required

Total size of the file to be uploaded in bytes.

integer format: uint32
hash_sum
required

SHA-256 hash of the full file, encoded with standard padded Base64.

string format: byte
Example generated
{
"total_size": 1,
"hash_sum": "example"
}

Successful response containing the upload session ID.

Media type application/json

Response payload for a chunked upload initialization.

object
upload_id
required

Unique identifier for the upload session.

string
Example generated
{
"upload_id": "example"
}

Bad Request - missing or invalid parameters.

Media type application/json
string
Example generated
example

Unauthorized - missing, expired, or invalid token.

Media type application/json
string
Example generated
example

Unsupported Media Type - Content-Type must be application/json.

Media type application/json
string
Example generated
example

Too Many Requests - rate limit exceeded.

Media type application/json
string
Example generated
example