This is the official API for files and datasets. Public files are readable without a key. Private files, uploads, deletes, metadata, and stats require an API key.
Use this for non-sensitive files and datasets.
GET /api/v1/files/public/example.csv
Use this for sensitive files, uploads, deletes, and metadata.
Authorization: Bearer YOUR_API_KEY
GET /api/health GET /api/openapi.json GET /api/v1/files/public/report.json GET /api/v1/files/private/finance.sql PUT /api/v1/files/public/newfile.csv DELETE /api/v1/files/private/oldfile.csv GET /api/v1/datasets?scope=public GET /api/v1/datasets/public/report.json GET /api/v1/rows/public/report.json GET /api/v1/stats
Upload any CSV or JSON file once. The API stores the raw file in R2 and the parsed rows in D1. New files use the same upload route. No code changes are needed.