๐Ÿš€Getting Started

Learn how to quickly authenticate, upload your first file, and start serving URLs with Stow.

Step 1: Authenticate

Use your Stow API key (created during Cloud Account Setup) to authenticate your API requests. Example header:

Authorization: Bearer <YOUR_API_KEY>

Step 2: Upload a file

Send a POST request to the Stow API with your file attached. You can optionally include a directory to organize your file.

Example using curl:

curl -X POST https://api.stow.io/upload
-H "Authorization: Bearer <YOUR_API_KEY>"
-F "[email protected]"
-F "directory=profile-images/"

Response:

{ "url": "https://cdn.stow.io/profile-images/myphoto.png" }

Step 3: Use your file URL

After a successful upload, Stow returns a public URL for immediate use in your application, website, or anywhere you need it.

Optional: Use directories

If you included a directory field, your file will appear under that path in the URL (e.g., profile-images/).

Thatโ€™s it!

No complex setup, no backend code required โ€” just upload and go.

Tip: Check out the Examples & Recipes section for common patterns and integration ideas.

Last updated