Upload File

Upload a CSV, JSON, or Excel file.

Accepts either a Supabase JWT or an API key (ntr_…) in the Authorization: Bearer header.

The optional folder form field places the file in that folder (found-or-created on the fly). It takes precedence over any path prefix embedded in the filename. Without it, the folder is still derived from a /-separated filename prefix; no folder means the file lands at root.

Usage (API key)::

curl -X POST https://api.example.com/api/v1/files/upload \
    -H "Authorization: Bearer ntr_..." \
    -F "file=@data.csv" \
    -F "folder=invoices/2024"