convex-file-storage

Call a mutation that returns ctx.storage.generateUploadUrl(), then POST the file to that URL with the correct Content-Type header. The response contains a storageId, which you save to your own table via a second mutation.

Use ctx.storage.getUrl(storageId) inside a query to resolve a storage ID into a servable URL. Return the URL alongside file metadata so React components can render images, PDFs, or download links.

Yes, actions running in the Node environment can create a Blob from generated content and persist it with ctx.storage.store(blob), which returns a storage ID. This works for PDFs, API-generated images, and other binary outputs.

Query the _storage system table with ctx.db.system.get(storageId) to retrieve contentType, sha256, size, and creation time. The older getMetadata approach is deprecated in favor of this system table access.

The most common cause is omitting the Content-Type header when POSTing to the upload URL, which prevents correct serving. Also verify the storage ID is valid and the file has not been deleted from storage.

Deleting a database row does not remove the underlying storage object, leaving orphaned files. Always call ctx.storage.delete(storageId) before removing the database record that references it.