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

# AWS S3

> AWS S3 provider to query S3 buckets

## Authentication

This provider requires authentication.

* **access\_key**: S3 Access Token (Leave empty if using IAM role at EC2) (required: False, sensitive: True)
* **secret\_access\_key**: S3 Secret Access Token (Leave empty if using IAM role at EC2) (required: False, sensitive: True)

## In workflows

This provider can be used in workflows.

As "step" to query data, example:

```yaml theme={null}
steps:
    - name: Query s3
      provider: s3
      config: "{{ provider.my_provider_name }}"
      with:
        bucket: {value}  
```

Check the following workflow examples:

* [consts\_and\_dict.yml](https://github.com/keephq/keep/blob/main/examples/workflows/consts_and_dict.yml)
* [update\_workflows\_from\_s3.yml](https://github.com/keephq/keep/blob/main/examples/workflows/update_workflows_from_s3.yml)

## Limitations

Querying only yaml, yml, json, xml and csv files.

## Scopes

Please note that during the installation, the provider is performing `list_buckets` to validate the config. Here is an example IAM policy:

```
{
	"Version": "2025-01-15",
	"Statement": [
		{
			"Sid": "VisualEditor0",
			"Effect": "Allow",
			"Action": [
				"s3:ListBucket",
				"s3:GetObject",
				"s3:GetBucketLocation",
				"s3:ListAllMyBuckets"
			],
			"Resource": "*"
		}
	]
}
```