> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flowx.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List storage buckets

> Retrieve a list of all available storage buckets in the document storage system

> [!WARNING]
>
> **Reference under review.** The path of this endpoint (`/internal/storage/...`) indicates it is an internal document-plugin operation used between FlowX services, not a public integration API. For supported integration patterns, see [Consuming FlowX from external apps](https://docs.flowx.ai/6.x/docs/platform-deep-dive/integrations/consuming-flowx-from-external-apps.md).

This endpoint returns a comprehensive list of all storage buckets available in the document management system. Use this endpoint to discover available storage containers before performing operations like listing objects or uploading files.

> [!NOTE]
>
> Storage buckets are logical containers that organize and group related files. Each bucket has unique permissions and configuration settings.

## Authentication

This endpoint requires Bearer Token authentication. Include your API token in the Authorization header.

**Authorization** `string` *required*

Bearer token for API authentication. Format: `Bearer YOUR_API_TOKEN`

## URL Parameters

**documentUrl** `string` *required*

The base URL of the document storage service where buckets are managed.

**Example:** `https://document-service.your-domain.com`

**internal** `string` *required*

Path segment indicating this is an internal API call within the document service. This distinguishes internal system operations from external public APIs.

**storage** `string` *required*

Path segment specifying that this endpoint operates on storage resources. This groups all storage-related operations under a common path.

**buckets** `string` *required*

Path segment identifying the specific storage resource type being accessed. This endpoint targets bucket-level operations for listing available storage containers.

## Headers

**Cache-Control** `string` (default: no-cache)

Cache control directive. Use `no-cache` to ensure fresh bucket data.

**Accept** `string` (default: */*)

Content type that the client can accept. Supports `*/*` for all types.

**Accept-Encoding** `string` (default: gzip, deflate, br)

Acceptable encoding methods for response compression. Supports `gzip, deflate, br`.

## Request examples

```bash cURL theme={"dark"}
curl -X GET '{{documentUrl}}/internal/storage/buckets' \
  -H 'Authorization: Bearer YOUR_API_TOKEN' \
  -H 'Cache-Control: no-cache' \
  -H 'Accept: */*' \
  -H 'Accept-Encoding: gzip, deflate, br'
```

```javascript Node.js theme={"dark"}
const response = await fetch('{{documentUrl}}/internal/storage/buckets', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Cache-Control': 'no-cache',
    'Accept': '*/*'
  }
});

const buckets = await response.json();
```

```python Python theme={"dark"}
import requests

response = requests.get(
    '{{documentUrl}}/internal/storage/buckets',
    headers={
        'Authorization': 'Bearer YOUR_API_TOKEN',
        'Cache-Control': 'no-cache',
        'Accept': '*/*'
    }
)

buckets = response.json()
```


## Related topics

- [Listing stored files](https://docs.flowx.ai/6.x/docs/platform-deep-dive/core-extensions/content-management/documents-plugin/listing-stored-files.md)
- [FlowX.AI data architecture: which service uses which store](https://docs.flowx.ai/6.x/docs/platform-overview/data-architecture.md)
- [File Storage](https://docs.flowx.ai/6.x/docs/platform-deep-dive/integrations/file-storage.md)
- [Documents plugin setup](https://docs.flowx.ai/6.x/setup-guides/documents-plugin-setup.md)
- [AI Platform setup](https://docs.flowx.ai/6.x/setup-guides/ai-platform-setup.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.