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

# Amazon S3

## Synced Objects

Amazon S3 supports the following Synced Objects:

* [Files](/managed-sync/api/file-schema)

## Files

Send a request to [Enable Sync](/managed-sync/api/enable-a-sync) to start a file sync.

Syncs for Amazon S3 can be created with one of the following configurations:

* **Bucket Sync**: All files in the specified bucket will be synced.
* **Folder Sync**: Only files in the specified folder will be synced (recursively including all subfolders).
* **Sync of specific files**: Only a group of specific files will be synced.

<Tabs>
  <Tab title="Bucket Sync">
    ```json Example theme={null}
    {
        "integration": "amazons3",
        "pipeline": "files",
        "configuration": {
          "bucket": "my-s3-bucket"
        }
    }
    ```

    **Configuration options:**

    <ParamField path="bucket" type="string" required>
      The S3 bucket name to sync files from.
    </ParamField>

    <ParamField path="mimeTypes" type="string[]">
      An optional array of MIME types to filter synced files. Only files matching the specified MIME types will be synced.
    </ParamField>
  </Tab>

  <Tab title="Folder Sync">
    ```json Example theme={null}
    {
        "integration": "amazons3",
        "pipeline": "files",
        "configuration": {
          "bucket": "my-s3-bucket",
          "subfolder": "documents/"
        }
    }
    ```

    **Configuration options:**

    <ParamField path="bucket" type="string" required>
      The S3 bucket name to sync files from.
    </ParamField>

    <ParamField path="subfolder" type="string" required>
      A subfolder path within the bucket to limit the Sync scope to.
    </ParamField>

    <ParamField path="mimeTypes" type="string[]">
      An optional array of MIME types to filter synced files. Only files matching the specified MIME types will be synced.
    </ParamField>
  </Tab>

  <Tab title="Sync of specific files">
    ```json Example theme={null}
    {
        "integration": "amazons3",
        "pipeline": "files",
        "configuration": {
          "bucket": "my-s3-bucket",
          "fileIds": ["documents/document1.pdf", "documents/document2.pdf"]
        }
    }
    ```

    **Configuration options:**

    <ParamField path="bucket" type="string" required>
      The S3 bucket name to sync files from.
    </ParamField>

    <ParamField path="fileIds" type="string[]" required>
      A list of S3 file keys, including the path, to limit the Sync scope to.
    </ParamField>

    <ParamField path="mimeTypes" type="string[]">
      An optional array of MIME types to filter synced files. Only files matching the specified MIME types will be synced.
    </ParamField>
  </Tab>
</Tabs>