> ## 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](/5.9/docs/platform-deep-dive/integrations/consuming-flowx-from-external-apps).
</Warning>

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.

<Info>
  Storage buckets are logical containers that organize and group related files. Each bucket has unique permissions and configuration settings.
</Info>

## Authentication

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

<ParamField header="Authorization" type="string" required>
  Bearer token for API authentication. Format: `Bearer YOUR_API_TOKEN`
</ParamField>

## URL Parameters

<ParamField path="documentUrl" type="string" required>
  The base URL of the document storage service where buckets are managed.

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

<ParamField path="internal" type="string" required>
  Path segment indicating this is an internal API call within the document service. This distinguishes internal system operations from external public APIs.
</ParamField>

<ParamField path="storage" type="string" required>
  Path segment specifying that this endpoint operates on storage resources. This groups all storage-related operations under a common path.
</ParamField>

<ParamField path="buckets" type="string" required>
  Path segment identifying the specific storage resource type being accessed. This endpoint targets bucket-level operations for listing available storage containers.
</ParamField>

## Headers

<ParamField header="Cache-Control" type="string" default="no-cache">
  Cache control directive. Use `no-cache` to ensure fresh bucket data.
</ParamField>

<ParamField header="Accept" type="string" default="*/*">
  Content type that the client can accept. Supports `*/*` for all types.
</ParamField>

<ParamField header="Accept-Encoding" type="string" default="gzip, deflate, br">
  Acceptable encoding methods for response compression. Supports `gzip, deflate, br`.
</ParamField>

## Request examples

<RequestExample>
  ```bash cURL theme={"system"}
  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'
  ```
</RequestExample>

<CodeGroup>
  ```javascript Node.js theme={"system"}
  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={"system"}
  import requests

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

  buckets = response.json()
  ```
</CodeGroup>


## Related topics

- [Data architecture](/5.9/docs/platform-overview/data-architecture.md)
- [Listing stored files](/5.9/docs/platform-deep-dive/core-extensions/content-management/documents-plugin/listing-stored-files.md)
- [AI Platform setup](/5.9/setup-guides/ai-platform-setup.md)
- [Update environment variables](/release-notes/v5.x/v5.1.x-lts/v5.1.0-october-2025/migrating-from-v4.7.x-to-5.1/environment-variables.md)
- [FlowX CMS setup](/5.9/setup-guides/cms-setup.md)