# 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

<table><thead><tr><th width="226.7999267578125">Category</th><th>Description</th></tr></thead><tbody><tr><td><a href="/pages/Akx2ZCRINLZ8Z5SovHel"><strong>Bucket</strong></a></td><td>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.</td></tr><tr><td><a href="/pages/T4lIisZTXikF2Jz2eSjP"><strong>Repo Storage API keys</strong></a></td><td>Create, list, update, and delete scoped API keys per repository to control how clients access storage via READ, WRITE, or ADMIN permissions.</td></tr><tr><td><a href="/pages/1UucJUQDNTPIGmRjPnLQ"><strong>Storage Bridge Node Registration</strong></a></td><td>Register and unregister bridge nodes using cryptographic signatures, and manage organization-level keys and node associations for secure, authenticated node operations.</td></tr><tr><td><a href="/pages/z3MmWW7AlQnsk9LpbVOF"><strong>Bridge Node Status</strong></a></td><td>List public and organization-specific nodes, and fetch real-time availability and performance stats to inform routing and monitoring decisions.</td></tr></tbody></table>

## Cloud Storage API Calls

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

### Bucket Management

| Method                                                                 | API Reference                                                                                                                                            | Description                                                                                      |
| ---------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ |
| <mark style="color:green;">`GET`</mark>`/bucket`                       | [**get\_\_bucket**](/support-reference/platform-api-reference/storage-apis/bucket-management/get__bucket.md)                                             | List all buckets belonging to the authenticated user's organization.                             |
| <mark style="color:green;">`GET`</mark>`/bucket/stats`                 | [**get\_\_bucket\_stats**](/support-reference/platform-api-reference/storage-apis/bucket-management/get__bucket_stats.md)                                | Retrieve usage and performance statistics for one or more storage buckets.                       |
| <mark style="color:orange;">`POST`</mark>`/bucket`                     | [**post\_\_bucket**](/support-reference/platform-api-reference/storage-apis/bucket-management/post__bucket.md)                                           | Create a new storage bucket with credentials for AWS, GCS, Azure, or S3/GCS-compatible services. |
| <mark style="color:green;">`GET`</mark>`/bucket/available`             | [**get\_\_bucket\_available**](/support-reference/platform-api-reference/storage-apis/bucket-management/get__bucket_available.md)                        | List available buckets that can be used for new repositories.                                    |
| <mark style="color:green;">`GET`</mark>`/bucket/{bucketId}/status`     | [**get\_\_bucket\_{bucketId}\_status**](/support-reference/platform-api-reference/storage-apis/bucket-management/get__bucket_-bucketid-_status.md)       | Get status and node information for a specific bucket.                                           |
| <mark style="color:orange;">`POST`</mark>`/bucket/{bucketId}/stats`    | [**post\_\_bucket\_{bucketId}\_stats**](/support-reference/platform-api-reference/storage-apis/bucket-management/post__bucket_-bucketid-_stats.md)       | Get daily statistics for a specific bucket.                                                      |
| <mark style="color:blue;">`PUT`</mark>`/bucket/{bucketId}`             | [**put\_\_bucket\_{bucketId}**](/support-reference/platform-api-reference/storage-apis/bucket-management/put__bucket_-bucketid.md)                       | Update an existing bucket's configuration.                                                       |
| <mark style="color:red;">`DELETE`</mark>`/bucket/{bucketId}`           | [**delete\_\_bucket\_{bucketId}**](/support-reference/platform-api-reference/storage-apis/bucket-management/delete__bucket_-bucketid.md)                 | Delete a bucket (soft delete).                                                                   |
| <mark style="color:orange;">`POST`</mark>`/bucket/{bucketId}/validate` | [**post\_\_bucket\_{bucketId}\_validate**](/support-reference/platform-api-reference/storage-apis/bucket-management/post__bucket_-bucketid-_validate.md) | Validate bucket accessibility and connectivity.                                                  |

### Repo Storage API Keys

| Method                                                                     | API Reference                                                                                                                                                 | Description                                                     |
| -------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------- |
| <mark style="color:green;">`GET`</mark>`/repo/{repoId}/apikey`             | [**get\_\_repo\_{repoId}\_apikey**](/support-reference/platform-api-reference/storage-apis/api_keys/get__repo_-repoid-_apikey.md)                             | Retrieve all API keys associated with the specified repository. |
| <mark style="color:orange;">`POST`</mark>`/repo/{repoId}/apikey`           | [**post\_\_repo\_{repoId}\_apikey**](/support-reference/platform-api-reference/storage-apis/api_keys/post__repo_-repoid-_apikey.md)                           | Create a new API key for the specified repository.              |
| <mark style="color:blue;">`PUT`</mark>`/repo/{repoId}/apikey/{apikeyId}`   | [**put\_\_repo\_{repoId}\_apikey\_{apikeyId}**](/support-reference/platform-api-reference/storage-apis/api_keys/put__repo_-repoid-_apikey_-apikeyid.md)       | Update the name or access level of an existing API key.         |
| <mark style="color:red;">`DELETE`</mark>`/repo/{repoId}/apikey/{apikeyId}` | [**delete\_\_repo\_{repoId}\_apikey\_{apikeyId}**](/support-reference/platform-api-reference/storage-apis/api_keys/delete__repo_-repoid-_apikey_-apikeyid.md) | Revoke and delete a specific API key.                           |

### Storage Bridge Node Registration

| Method                                                                        | API Reference                                                                                                                                                                | Description                                                  |
| ----------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
| <mark style="color:orange;">`POST`</mark>`/register`                          | [**post\_\_register**](/support-reference/platform-api-reference/storage-apis/node-registration/post__register.md)                                                           | Register a new bridge node using cryptographic signature.    |
| <mark style="color:orange;">`POST`</mark>`/unregister`                        | [**post\_\_unregister**](/support-reference/platform-api-reference/storage-apis/node-registration/post__unregister.md)                                                       | Unregister a bridge node from the platform.                  |
| <mark style="color:orange;">`POST`</mark>`/organization/{orgId}/key`          | [**post\_\_organization\_{orgId}\_key**](/support-reference/platform-api-reference/storage-apis/node-registration/post__organization_-orgid-_key.md)                         | Generate a new RSA key pair for organization authentication. |
| <mark style="color:green;">`GET`</mark>`/organization/{orgId}/key`            | [**get\_\_organization\_{orgId}\_key**](/support-reference/platform-api-reference/storage-apis/node-registration/get__organization_-orgid-_key.md)                           | List all organization keys with associated node information. |
| <mark style="color:red;">`DELETE`</mark>`/organization/{orgId}/key`           | [**delete\_\_organization\_{orgId}\_key**](/support-reference/platform-api-reference/storage-apis/node-registration/delete__organization_-orgid-_key.md)                     | Delete all organization keys for the specified organization. |
| <mark style="color:red;">`DELETE`</mark>`/organization/{orgId}/key/{idKey}`   | [**delete\_\_organization\_{orgId}\_key\_{keyid}**](/support-reference/platform-api-reference/storage-apis/node-registration/delete__organization_-orgid-_key_-keyid.md)     | Delete a specific organization key by its ID.                |
| <mark style="color:red;">`DELETE`</mark>`/organization/{orgId}/node/{nodeId}` | [**delete\_\_organization\_{orgId}\_node\_{nodeId}**](/support-reference/platform-api-reference/storage-apis/node-registration/delete__organization_-orgid-_node_-nodeid.md) | Soft delete a node from the organization.                    |

### Bridge Node Status

| Method                                                               | API Reference                                                                                                                                         | Description                                                         |
| -------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |
| <mark style="color:green;">`GET`</mark>`/node`                       | [**get\_\_node**](/support-reference/platform-api-reference/storage-apis/node-information/get__node.md)                                               | List all active Flashback nodes and their associated metadata.      |
| <mark style="color:green;">`GET`</mark>`/stats/nodes/minute`         | [**get\_\_stats\_nodes\_minute**](/support-reference/platform-api-reference/storage-apis/node-information/get__stats_nodes_minute.md)                 | Retrieve minute-level performance and availability stats for nodes. |
| <mark style="color:green;">`GET`</mark>`/organization/{orgId}/nodes` | [**get\_\_organization\_{orgId}\_nodes**](/support-reference/platform-api-reference/storage-apis/node-information/get__organization_-orgid-_nodes.md) | List all private nodes belonging to the specified organization.     |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.flashback.tech/support-reference/platform-api-reference/storage-apis.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.