Upload a chunk of a file

POST

/v3/uploads/{upload_id}/chunks

curl --request POST \
  --url 'https://api.cardio.ai/v3/uploads/example/chunks?offset=1' \
  --header 'Content-Type: application/octet-stream' \
  --header 'X-Api-Token: <X-Api-Token>' \
  --data binary

• Production REST API endpoint.

Receives and stores a chunk of an ongoing file upload session.

Authorizations

• ApiToken

Parameters

Path Parameters

upload_id

required

string

Upload session ID.

Query Parameters

offset

required

integer format: int64

Byte offset for the chunk.

Request Body^required

Binary chunk data.

Media typeapplication/octet-stream

string format: binary

Responses

200

Operation completed successfully.

400

Bad Request - missing or invalid parameters.

Media typeapplication/json

Error payload carried by every non-2xx response.

object

message

required

Human-readable description of the failure. The wording is not part of the API contract; do not match on it programmatically.

string

reason

Stable machine-readable failure code in snake_case, e.g. “api_token_missing” or “invalid_task_id”. Omitted for 500 responses.

string

Example^generated

{
  "message": "example",
  "reason": "example"
}

401

Unauthorized - missing, expired, or invalid token.

Media typeapplication/json

Error payload carried by every non-2xx response.

object

message

required

Human-readable description of the failure. The wording is not part of the API contract; do not match on it programmatically.

string

reason

Stable machine-readable failure code in snake_case, e.g. “api_token_missing” or “invalid_task_id”. Omitted for 500 responses.

string

Example^generated

{
  "message": "example",
  "reason": "example"
}

429

Too Many Requests - rate limit exceeded.

Media typeapplication/json

Error payload carried by every non-2xx response.

object

message

required

Human-readable description of the failure. The wording is not part of the API contract; do not match on it programmatically.

string

reason

Stable machine-readable failure code in snake_case, e.g. “api_token_missing” or “invalid_task_id”. Omitted for 500 responses.

string

Example^generated

{
  "message": "example",
  "reason": "example"
}