Skip to main content

Upload a file

POST 
/v1/files

Upload a file to storage. Files are stored as content-addressed blobs.

By default, files are stored as ephemeral (temporary). Set persist=true to store files permanently in the project's file storage. Persistent files can be listed via GET /v1/files/persistent and are billed using storage credits.

For ephemeral files, optionally set ttl_hours to expire the metadata record after N hours.

Project Scoping: For OAuth auth, requires X-Project-ID header.

Request​

Responses​

File uploaded successfully