curl -X POST https://api.u1.archetypeai.app/v0.5/files/uploads/initiate \
  -H "Authorization: Bearer $ATAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "filename": "training-data.parquet",
    "file_type": "application/x-parquet",
    "num_bytes": 1073741824,
    "resume_if_started": false
  }'

import requests
import os

api_key = os.environ.get("ATAI_API_KEY")

response = requests.post(
    "https://api.u1.archetypeai.app/v0.5/files/uploads/initiate",
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    json={
        "filename": "training-data.parquet",
        "file_type": "application/x-parquet",
        "num_bytes": 1_073_741_824,
        "resume_if_started": False,
    },
)

result = response.json()
print(f"upload_id: {result['upload_id']}")
print(f"num_parts: {result['num_parts']}")

const response = await fetch(
  "https://api.u1.archetypeai.app/v0.5/files/uploads/initiate",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.ATAI_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      filename: "training-data.parquet",
      file_type: "application/x-parquet",
      num_bytes: 1_073_741_824,
      resume_if_started: false,
    }),
  }
);

const result = await response.json();
console.log(`upload_id: ${result.upload_id}`);
console.log(`num_parts: ${result.num_parts}`);

{
  "upload_id": "upl_1mehceg8cn80qsekh46143whrx",
  "file_uid": "fil_5hx819ysp38n2rt1f5fv0wsxgh",
  "file_name": "training-data.parquet",
  "total_bytes": 1073741824,
  "num_parts": 128,
  "part_size": 8388608,
  "integrity_algorithm": "crc32c",
  "is_resume": false,
  "parts": [
    {
      "part_number": 1,
      "url": "https://storage.example.com/upload/upl_1mehceg8cn80qsekh46143whrx/1?X-Amz-Signature=...",
      "offset": 0,
      "length": 8388608,
      "expires_at": "2026-04-28T15:32:18Z"
    },
    {
      "part_number": 2,
      "url": "https://storage.example.com/upload/upl_1mehceg8cn80qsekh46143whrx/2?X-Amz-Signature=...",
      "offset": 8388608,
      "length": 8388608,
      "expires_at": "2026-04-28T15:32:18Z"
    }
  ]
}

{
  "errors": [
    {
      "code": "invalid_request",
      "message": "num_bytes must be greater than zero.",
      "suggestion": "Specify the total file size in bytes and retry.",
      "error_uid": "err-xxxxxxxx"
    }
  ]
}

{
  "errors": [
    {
      "code": "unauthorized_request",
      "message": "Unauthorized or invalid access.",
      "suggestion": "Provide valid authentication credentials and ensure they have the required permissions.",
      "error_uid": "err-xxxxxxxx"
    }
  ]
}

{
  "errors": [
    {
      "code": "resume_mismatch",
      "message": "An in-progress upload exists for this filename but file_type or num_bytes do not match.",
      "suggestion": "Abort the existing upload or retry with the original file_type and num_bytes.",
      "error_uid": "err-xxxxxxxx"
    }
  ]
}