Skip to main content
POST
/
files
/
base64
# Encode the file first
base64 -i /path/to/local/file.csv -o /tmp/file.b64

curl -X POST https://api.u1.archetypeai.app/v0.5/files/base64 \
  -H "Authorization: Bearer $ATAI_API_KEY" \
  -F "file=@/tmp/file.b64;filename=file.csv"

{
  "is_valid": true,
  "file_id": "file-abc123",
  "file_uid": "8f2c1e5a-7b3d-4d9e-9c1a-2f5b7d8e4a6c"
}
File Upload Note: The interactive playground doesn’t support file uploads due to browser limitations. Use the cURL examples below to test file uploads.

​
Overview

Upload a file whose contents have been Base64-encoded. The request body is multipart/form-data; the server decodes the Base64 payload as it streams. Use this endpoint when the source environment cannot transmit raw binary contents (for example, embedding a small file in a JSON-bearing channel that has been wrapped in a multipart form). For files larger than the simple-upload cap, or any case that needs resumable uploads, use the direct-to-cloud multipart flow (up to 250 GB) instead.

​
Request

The request must be sent as multipart/form-data with a form field containing the base64-encoded file contents. The server decodes the contents on the fly.

​
Supported File Types

The server’s Content-Type validator accepts:
  • Images: image/jpeg, image/png
  • Video: video/mp4
  • Text & data: text/plain, text/csv, application/json
JSONL (application/x-ndjson) is not accepted by this endpoint — use the multipart flow for JSONL. Maximum size: 512 MB (after Base64 encoding). The Developer Console UI caps its uploads through this endpoint at 255 MB.

​
Response

​
is_valid
boolean
Whether the upload was successful. Check this field to detect errors.
​
file_id
string
Filename of the uploaded file. Use this to download, delete, or fetch metadata for the file.
​
file_uid
string
Internal unique identifier for the uploaded file.
# Encode the file first
base64 -i /path/to/local/file.csv -o /tmp/file.b64

curl -X POST https://api.u1.archetypeai.app/v0.5/files/base64 \
  -H "Authorization: Bearer $ATAI_API_KEY" \
  -F "file=@/tmp/file.b64;filename=file.csv"

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