curl -X GET '{{documentURL}}/internal/storage/buckets/qualitance-dev-paperflow-1416' \
-H 'Authorization: Bearer YOUR_API_TOKEN' \
-H 'Cache-Control: no-cache' \
-H 'Accept: */*' \
-H 'Accept-Encoding: gzip, deflate, br'
List objects in a bucket
Retrieve all objects stored within a specific storage bucket, including files, metadata, and access information
GET
{documentURL}
/
internal
/
storage
/
buckets
/
{BUCKET_NAME}
curl -X GET '{{documentURL}}/internal/storage/buckets/qualitance-dev-paperflow-1416' \
-H 'Authorization: Bearer YOUR_API_TOKEN' \
-H 'Cache-Control: no-cache' \
-H 'Accept: */*' \
-H 'Accept-Encoding: gzip, deflate, br'
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.Objects within a bucket include all file types, documents, images, and any other data stored in the specified container. Each object includes metadata such as size, modification date, and access permissions.
Authentication
This endpoint requires Bearer Token authentication. Include your API token in the Authorization header.Bearer token for API authentication. Format:
Bearer YOUR_API_TOKENURL Parameters
The base URL of the document storage service where buckets are managed.Example:
https://document-service.your-domain.comPath segment indicating this is an internal API call within the document service. This distinguishes internal system operations from external public APIs.
Path segment specifying that this endpoint operates on storage resources. This groups all storage-related operations under a common path.
Path segment identifying the storage resource type. This indicates operations on bucket-level resources.
The unique identifier for the target storage bucket. This should match exactly with an existing bucket name from your organization.Example:
qualitance-dev-paperflow-1416Headers
Cache control directive. Use
no-cache to ensure fresh object listings, especially after recent uploads or deletions.Content type that the client can accept. Supports
*/* for all types.Acceptable encoding methods for response compression. Supports
gzip, deflate, br.Request examples
curl -X GET '{{documentURL}}/internal/storage/buckets/qualitance-dev-paperflow-1416' \
-H 'Authorization: Bearer YOUR_API_TOKEN' \
-H 'Cache-Control: no-cache' \
-H 'Accept: */*' \
-H 'Accept-Encoding: gzip, deflate, br'
const bucketName = 'qualitance-dev-paperflow-1416';
const response = await fetch(`{{documentURL}}/internal/storage/buckets/${bucketName}`, {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_API_TOKEN',
'Cache-Control': 'no-cache',
'Accept': '*/*'
}
});
const objects = await response.json();
import requests
bucket_name = 'qualitance-dev-paperflow-1416'
response = requests.get(
f'{{documentURL}}/internal/storage/buckets/{bucket_name}',
headers={
'Authorization': 'Bearer YOUR_API_TOKEN',
'Cache-Control': 'no-cache',
'Accept': '*/*'
}
)
objects = response.json()
Last modified on May 12, 2026
Related topics
Listing stored filesData architectureAI Platform setupCollectionUpdate environment variablesWas this page helpful?
⌘I