Decillion
Infrastructure

Storage

Upload, list, download and delete files.

Upload a file

POST
/v1/files
Upload a file as multipart form data. Files can be up to 25 MB.
Key permission: Storage: Write
FORM FIELDS
file
file
required
The file to store.
purpose
string
A free-form label, for example dataset . Defaults to general .
EXAMPLE
curl https://api.decillionai.com/v1/files \ -H "Authorization: Bearer $DECILLION_API_KEY" \ -F file=@./customers.csv \ -F purpose=dataset
Response
{ "id": "0000000000000001f1e2d3c4b5a69788", "name": "customers.csv", "size": 2048, "mime": "text/csv", "purpose": "dataset", "created_at": "2026-10-15T12:00:00Z" }

What storing files costs

Files are charged to the organization's balance for as long as they are kept: the gigabytes held, at a price per GB per month, charged by the hour. Uploading is refused when the balance is empty, and deleting a file stops its charge. Files are never deleted for non-payment.
GET
/v1/storage
What the organization stores and what it costs now.
Key permission: Storage: Read
EXAMPLE
curl https://api.decillionai.com/v1/storage \ -H "Authorization: Bearer $DECILLION_API_KEY"
Response
{ "files": 3, "used_bytes": 52428800, "max_file_bytes": 26214400, "price_per_gb_month": 0.05, "cost_per_month": 0.0024, "currency": "USD" }

List and download

GET
/v1/files
List your files, newest first.
Key permission: Storage: Read
GET
/v1/files/{id}
A file's details.
Key permission: Storage: Read
GET
/v1/files/{id}/content
The file's bytes, with its own Content-Type .
Key permission: Storage: Read
EXAMPLE
curl https://api.decillionai.com/v1/files/0000000000000001f1e2d3c4b5a69788/content \ -H "Authorization: Bearer $DECILLION_API_KEY"

Delete a file

DELETE
/v1/files/{id}
Delete a file for good.
Key permission: Storage: Write
Previous
Computers
Next
Usage and billing