> ## 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.

# Listing stored files

> View files stored in S3-compatible buckets (such as MinIO or Amazon S3) using the Documents Plugin REST API.

To determine the partitioning strategy used for storing generated documents, you can access the following key in the configuration:

`application.file-storage.partition-strategy`

```yaml theme={"system"}
application:
  defaultLocale: en
  supportedLocales: en, ro
  #fileStorageType is the configuration that activates one FileContentService implementation. Valid values: minio / fileSystem
  file-storage:
    type: s3
    disk-directory: MS_SVC_DOCUMENT
    partition-strategy: NONE

```

The `partition-strategy` property can have two possible values:

* **NONE**: Documents are saved in separate buckets for each process instance. Each process instance has its own dedicated bucket.
* **PROCESS\_DATE**: Documents are saved in a single bucket with a subfolder structure based on the process date. For example: `bucket/2022/2022-07-04/process-id-xxxx/customer-id/file.pdf`.

## REST API

The Documents Plugin provides the following REST API endpoints for interacting with the stored files:

### List buckets

<Check>
  Check out the [**List buckets API reference**](../../../../api/storage/list-buckets) for more details.
</Check>

* This endpoint returns a list of available buckets.

### List objects in a bucket

<Check>
  Check out the [**List objects in a bucket API reference**](../../../../api/storage/list-objects-in-buckets) for more details.
</Check>

* This endpoint retrieves a list of objects stored within a specific bucket. Replace `BUCKET_NAME` with the actual name of the desired bucket

### Download file

<Check>
  Check out the [**Download file API reference**](../../../../api/storage/download-file) for more details.
</Check>

* This endpoint allows you to download a file by specifying its path or key.