Skip to main content
POST
/
files
/
uploads
/
{upload_id}
/
parts
/
urls
curl -X POST https://api.u1.archetypeai.app/v0.5/files/uploads/upl_1mehceg8cn80qsekh46143whrx/parts/urls \
  -H "Authorization: Bearer $ATAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "part_numbers": [43, 44, 45]
  }'

{
  "parts": [
    {
      "part_number": 43,
      "url": "https://storage.example.com/upload/upl_1mehceg8cn80qsekh46143whrx/43?X-Amz-Signature=...",
      "offset": 352321536,
      "length": 8388608,
      "expires_at": "2026-04-28T16:18:42Z"
    },
    {
      "part_number": 44,
      "url": "https://storage.example.com/upload/upl_1mehceg8cn80qsekh46143whrx/44?X-Amz-Signature=...",
      "offset": 360710144,
      "length": 8388608,
      "expires_at": "2026-04-28T16:18:42Z"
    },
    {
      "part_number": 45,
      "url": "https://storage.example.com/upload/upl_1mehceg8cn80qsekh46143whrx/45?X-Amz-Signature=...",
      "offset": 369098752,
      "length": 8388608,
      "expires_at": "2026-04-28T16:18:42Z"
    }
  ]
}

​
Overview

Generate presigned URLs for specific parts of an in-progress upload. Use this when a presigned URL returned from Initiate Upload is about to expire and the part has not yet been uploaded. For each requested part, the response may contain either a freshly generated URL or a previously issued one that is not close to expiration; expires_at always reflects the URL actually returned. The response’s parts array has the same length and order as the request’s part_numbers. Duplicate part numbers in the request produce duplicate entries in the response that share a single presigned URL.
Part numbers are 1-based — the first part of an upload is 1, not 0.

​
Path Parameters

​
upload_id
string
required
Upload identifier returned by Initiate Upload

​
Request Body

​
part_numbers
array
required
1-based part numbers to generate presigned URLs for. Each entry must be in range for the upload (1 ≤ part_number ≤ num_parts).

​
Response

​
parts
array
One descriptor per entry in part_numbers, in the same order
curl -X POST https://api.u1.archetypeai.app/v0.5/files/uploads/upl_1mehceg8cn80qsekh46143whrx/parts/urls \
  -H "Authorization: Bearer $ATAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "part_numbers": [43, 44, 45]
  }'

{
  "parts": [
    {
      "part_number": 43,
      "url": "https://storage.example.com/upload/upl_1mehceg8cn80qsekh46143whrx/43?X-Amz-Signature=...",
      "offset": 352321536,
      "length": 8388608,
      "expires_at": "2026-04-28T16:18:42Z"
    },
    {
      "part_number": 44,
      "url": "https://storage.example.com/upload/upl_1mehceg8cn80qsekh46143whrx/44?X-Amz-Signature=...",
      "offset": 360710144,
      "length": 8388608,
      "expires_at": "2026-04-28T16:18:42Z"
    },
    {
      "part_number": 45,
      "url": "https://storage.example.com/upload/upl_1mehceg8cn80qsekh46143whrx/45?X-Amz-Signature=...",
      "offset": 369098752,
      "length": 8388608,
      "expires_at": "2026-04-28T16:18:42Z"
    }
  ]
}