Cloud Storage

Flashback lets you register and manage storage buckets across AWS, GCS, Azure, and S3/GCS-compatible providers, including usage and health stats. Repositories expose these buckets via scoped Repo Storage API keys so apps can access data with precise READ/WRITE/ADMIN control. Storage Bridge Nodes register securely with the platform using cryptographic signatures and organization keys, then report their status (availability, region, performance) so you can monitor and route traffic intelligently.

Reference Table

Category	Description
Bucket	Manage storage buckets across AWS, GCS, Azure, and S3/GCS-compatible providers: create, list, update, delete (soft delete), validate connectivity, and retrieve usage/performance stats.
Repo Storage API keys	Create, list, update, and delete scoped API keys per repository to control how clients access storage via READ, WRITE, or ADMIN permissions.
Storage Bridge Node Registration	Register and unregister bridge nodes using cryptographic signatures, and manage organization-level keys and node associations for secure, authenticated node operations.
Bridge Node Status	List public and organization-specific nodes, and fetch real-time availability and performance stats to inform routing and monitoring decisions.

Cloud Storage API Calls

The table below consolidates all storage-related endpoints across the four sub-categories.

Bucket Management

Method	API Reference	Description
GET/bucket	get__bucket	List all buckets belonging to the authenticated user's organization.
GET/bucket/stats	get__bucket_stats	Retrieve usage and performance statistics for one or more storage buckets.
POST/bucket	post__bucket	Create a new storage bucket with credentials for AWS, GCS, Azure, or S3/GCS-compatible services.
GET/bucket/available	get__bucket_available	List available buckets that can be used for new repositories.
GET/bucket/{bucketId}/status	get__bucket_{bucketId}_status	Get status and node information for a specific bucket.
POST/bucket/{bucketId}/stats	post__bucket_{bucketId}_stats	Get daily statistics for a specific bucket.
PUT/bucket/{bucketId}	put__bucket_{bucketId}	Update an existing bucket's configuration.
DELETE/bucket/{bucketId}	delete__bucket_{bucketId}	Delete a bucket (soft delete).
POST/bucket/{bucketId}/validate	post__bucket_{bucketId}_validate	Validate bucket accessibility and connectivity.

Repo Storage API Keys

Method	API Reference	Description
GET/repo/{repoId}/apikey	get__repo_{repoId}_apikey	Retrieve all API keys associated with the specified repository.
POST/repo/{repoId}/apikey	post__repo_{repoId}_apikey	Create a new API key for the specified repository.
PUT/repo/{repoId}/apikey/{apikeyId}	put__repo_{repoId}_apikey_{apikeyId}	Update the name or access level of an existing API key.
DELETE/repo/{repoId}/apikey/{apikeyId}	delete__repo_{repoId}_apikey_{apikeyId}	Revoke and delete a specific API key.

Storage Bridge Node Registration

Method	API Reference	Description
POST/register	post__register	Register a new bridge node using cryptographic signature.
POST/unregister	post__unregister	Unregister a bridge node from the platform.
POST/organization/{orgId}/key	post__organization_{orgId}_key	Generate a new RSA key pair for organization authentication.
GET/organization/{orgId}/key	get__organization_{orgId}_key	List all organization keys with associated node information.
DELETE/organization/{orgId}/key	delete__organization_{orgId}_key	Delete all organization keys for the specified organization.
DELETE/organization/{orgId}/key/{idKey}	delete__organization_{orgId}_key_{keyid}	Delete a specific organization key by its ID.
DELETE/organization/{orgId}/node/{nodeId}	delete__organization_{orgId}_node_{nodeId}	Soft delete a node from the organization.

Bridge Node Status

Method	API Reference	Description
GET/node	get__node	List all active Flashback nodes and their associated metadata.
GET/stats/nodes/minute	get__stats_nodes_minute	Retrieve minute-level performance and availability stats for nodes.
GET/organization/{orgId}/nodes	get__organization_{orgId}_nodes	List all private nodes belonging to the specified organization.