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

# Amazon S3

> Connect to an Amazon S3 bucket.

## Setup

Provide the bucket, region, and optional key prefix, then an access key pair. Use an IAM user or role limited to read-only access on that bucket.

Add the connection under **Settings -> Connections**. Saving verifies it with a read-only test call.

## Operations

Apps can call read operations only. Operations marked Edit exist in the connector's catalog but cannot be granted to apps yet. Apps declare the operations they use per connection; see [Using connections in apps](/connections/overview).

| Operation | Effect | Description |
| - | - | - |
| `object.list` | Read | List objects under a prefix. |
| `object.metadata` | Read | Read one object's metadata. |
| `object.read` | Read | Read one object. |
| `object.write` | Edit | Write or replace one object. |
| `object.delete` | Edit | Delete one object. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.