Buzstorage Quick Start

Start building with Buzstorage in minutes. We’ll walk you through account onboarding, API key management, and your first media integration.

1. Identity & Profile

Start by creating your account. Once registered, you must complete your Company Settings. This profile information is required to unlock full API capabilities and ensure secure billing routes.

Verify your company details under Settings > Company Profile to activate your developer identity.

2. Apps & Environments

Navigate to the Apps section to create a new application instance. Every app is provisioned with a Production environment by default. You can manually add Staging and Development environments to separate your testing and live traffic.

Production

Staging

Development

3. API Key Management

Each environment has its own set of Access Keys. These keys allow you to authenticate your requests and interact with our media pipeline across Development, Staging, and Production.

Global API CredentialsActive Keys

192.168.1.110.0.0.5

4. Infrastructure Hierarchy

Buzstorage follows a logical folder architecture with full support for nested directories. You can target deep locations using logical paths, allowing for precise organization of media assets. If a specified path does not exist, our system creates the entire hierarchy automatically, ensuring your uploads are always correctly contextualized without pre-configuring folders.

Logical Path Resolution

Specify your target location via the folderPath parameter (e.g., campaign/2026/branding). Storage accounting propagates instantly from the child file up to the master root directory.

You must choose whether a folder is Public or Private. Private folders enforce strict security; files within them are permanently private and can only be accessed via trusted, authenticated requests. For public folders, you may granularly set individual files to private during upload via the isPublic=false flag.

5. Integration

Authenticate via the Authorization header using the pattern Bearer <ID>:<SECRET>.Note: You must include the full key strings including their prefixes (e.g., ak_prod_... and sk_prod_...). Buzstorage identifies your environment (Production, Staging, or Development) automatically based on these unique keys.

Automatic Environment Identification

The security layer resolves the target environment and application context directly from your access credentials; an explicit environment header is optional.

curl -X POST https://api.buzstorage.com/api/public/v1/upload \
  -H "Authorization: Bearer <ACCESS_KEY_ID>:<SECRET_ACCESS_KEY>" \
  -F "file=@/path/to/image.jpg" \
  -F "folderPath=campaign/2026/branding" \
  -F "isPublic=false"

6. Content Retrieval

Query your media assets using global or scoped retrievals. Authenticate these requests using the same Vault credentials as your uploads.

Global Application List

List every file assigned to a particular application by name or ID.

curl -X GET "https://api.buzstorage.com/api/protected/files/list?applicationName=Buzmedia" \
  -H "Authorization: Bearer <ACCESS_KEY_ID>:<SECRET_ACCESS_KEY>"

Scoped Folder List

List files confined to a specific logical folder path or directory name.

curl -X GET "https://api.buzstorage.com/api/protected/files/list?folderPath=campaign/2026/branding" \
  -H "Authorization: Bearer <ACCESS_KEY_ID>:<SECRET_ACCESS_KEY>"

PreviousOverview

NextFree Trial

curl -X POST https://api.buzstorage.com/api/public/v1/upload \ -H "Authorization: Bearer <ACCESS_KEY_ID>:<SECRET_ACCESS_KEY>" \ -F "file=@/path/to/image.jpg" \ -F "folderPath=campaign/2026/branding" \ -F "isPublic=false"