> For the complete documentation index, see [llms.txt](https://docs.dat-hub.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dat-hub.com/integrations/sources/amazon-s3.md).

# Amazon S3

## Overview

The Amazon S3 source connector allows you to extract data from AWS S3 Buckets into your desired vector database.

## Prerequisites

You will need the following AWS permissions:

* `ListBuckets` - Returns a list of all buckets owned by the authenticated sender of the request.
* `ListObjectsV2` - Returns some or all (up to 1,000) of the objects in a bucket.
* `GetObject` - Retrieves an object from Amazon S3.

## Configuration Options

* **Name:** This field represents the name you want to assign to the actor instance responsible for managing the Amazon S3 source. Choose a descriptive and unique name to easily identify this instance within your data activation tool (dat).
* **AWS Access Key:** Specify your AWS access key for authentication. You can obtain your AWS access key and secret key from the AWS Management Console in the security credentials section of your IAM user.
* **AWS Secret Key:** Specify your AWS secret key for authentication. You can obtain your AWS access key and secret key from the AWS Management Console in the security credentials section of your IAM user.
* **Bucket Name:** Specify the AWS S3 Bucket Name from where you wish to extract data.
* **Region Name:** Specify the AWS region where the AWS S3 Bucket resides.

### Supported streams

The following streams are supported for this source:

* TXT
* PDF


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.dat-hub.com/integrations/sources/amazon-s3.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.