Skip to main content
POST
/
files
/
uploads
/
{upload_id}
/
parts
/
checkpoint
curl -X POST https://api.u1.archetypeai.app/v0.5/files/uploads/upl_1mehceg8cn80qsekh46143whrx/parts/checkpoint \
  -H "Authorization: Bearer $ATAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "parts": [
      { "part_number": 1, "part_token": "\"e1b3a4cd87f3...\"" },
      { "part_number": 2, "part_token": "\"a2c8f7b9e081...\"" },
      { "part_number": 3, "part_token": "\"d40fa2c81b9e...\"" }
    ]
  }'

{
  "num_checkpointed": 3
}

​
Overview

Checkpoint a subset of an upload’s completed parts. The server stores each part_token (the ETag returned from a successful part PUT) so that:
  • A later Initiate Upload call with resume_if_started=true skips the checkpointed parts and only returns presigned URLs for the remaining ones.
  • Checkpointed parts do not need to be re-supplied on the Complete Upload call.
Use this endpoint to make incremental progress durable when uploading a large file in many parts.
Direct-to-cloud file uploads support files up to 250GB.

​
Path Parameters

​
upload_id
string
required
Upload identifier returned by Initiate Upload

​
Request Body

​
parts
array
required
Completed parts to checkpoint

​
Response

​
num_checkpointed
integer
Number of parts that were newly checkpointed (equal to the number of parts in the request after validation)
curl -X POST https://api.u1.archetypeai.app/v0.5/files/uploads/upl_1mehceg8cn80qsekh46143whrx/parts/checkpoint \
  -H "Authorization: Bearer $ATAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "parts": [
      { "part_number": 1, "part_token": "\"e1b3a4cd87f3...\"" },
      { "part_number": 2, "part_token": "\"a2c8f7b9e081...\"" },
      { "part_number": 3, "part_token": "\"d40fa2c81b9e...\"" }
    ]
  }'

{
  "num_checkpointed": 3
}