curl -X POST https://api.u1.archetypeai.app/v0.5/files \
  -H "Authorization: Bearer $ATAI_API_KEY" \
  -F "file=@/path/to/local/file.csv"

import requests
import os

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

with open("/path/to/local/file.csv", "rb") as fh:
    response = requests.post(
        "https://api.u1.archetypeai.app/v0.5/files",
        headers={"Authorization": f"Bearer {api_key}"},
        files={"file": ("file.csv", fh, "text/csv")},
    )

result = response.json()
if result.get("is_valid"):
    print(f"Uploaded: {result['file_id']}")
else:
    print(f"Errors: {result.get('errors')}")

import fs from "node:fs";

const form = new FormData();
form.append("file", new Blob([fs.readFileSync("/path/to/local/file.csv")]), "file.csv");

const response = await fetch("https://api.u1.archetypeai.app/v0.5/files", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.ATAI_API_KEY}`,
  },
  body: form,
});

const result = await response.json();
if (result.is_valid) {
  console.log(`Uploaded: ${result.file_id}`);
} else {
  console.error("Errors:", result.errors);
}

{
  "is_valid": true,
  "file_id": "file-abc123",
  "file_uid": "8f2c1e5a-7b3d-4d9e-9c1a-2f5b7d8e4a6c"
}

{
  "errors": [
    {
      "code": "invalid_request",
      "message": "Multipart form is missing a file field.",
      "suggestion": "Include the file contents in a form field of the multipart request body.",
      "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": "file_already_exists",
      "message": "A file with this name already exists for the organization.",
      "suggestion": "Delete the existing file first or upload with a different filename.",
      "error_uid": "err-xxxxxxxx"
    }
  ]
}

{
  "errors": [
    {
      "code": "server_at_capacity",
      "message": "Server is at capacity. Retry later.",
      "suggestion": "Retry the request after a short delay using exponential backoff.",
      "error_uid": "err-xxxxxxxx"
    }
  ]
}