Skip to content
Last updated

Generate a resumable upload URL for large files that exceed the direct upload limit.

POSThttps://api.aitronos.com/v1/organizations/{organization_id}/stores/{store_id}/files/upload-url

Returns a signed, resumable upload URL for uploading large files (>31 MB). After uploading the file to the signed URL, call Register upload to add the file to the store and start processing.

Path Parameters

organization_id string required

The unique identifier of the organization (format: org_*).

store_id string required

The unique identifier of the vector store.

Request Body

file_name string required

The name of the file (1-255 characters).

file_size integer required

The file size in bytes (must be greater than 0).

mime_type string required

The MIME type of the file.

relative_path string optional

A relative path within the store for folder uploads.


Returns

An object containing the upload session URL, recommended chunk size, and expiry time.

cURL
curl -X POST "https://api.aitronos.com/v1/organizations/org_xyz789/stores/vs_abc123/files/upload-url" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "file_name": "large-dataset.csv",
    "file_size": 104857600,
    "mime_type": "text/csv",
    "relative_path": "data/imports"
  }'