Upload with the API or CLI

Follow the live contract

Use Astral's OpenAPI document, developer guide, JavaScript SDK, or Node CLI rather than reconstructing private Firebase writes.

Upload flow

1. Create an authenticated reservation with an idempotent request ID.
2. Upload bytes to the exact authorized destination.
3. Finalize with the expected metadata and digest.
4. Store the returned share identifier and URL.

Retry safely

Keep the same valid client request ID for a retry of the exact same input. A request ID must contain 16–128 URL-safe characters and cannot be reused for different upload parameters.