# List S3 objects

Canonical URL: https://docs.fuse.init.inc/integrations/aws/actions/s3.objects.list

List objects in one general-purpose bucket with optional prefix and delimiter. Requires s3:ListBucket.

Action ID: `s3.objects.list`
Provider: AWS (`aws`)
Contract version: 1

## Risk and exposure

- Risk: Read
- Idempotency: Safe — Safe to retry without coordination; repeats do not create additional side effects.
- Availability: Default
- Exposure: REST, SDK, MCP
- MCP hints: readOnly=true, destructive=false, idempotent=true, openWorld=true

## Required scopes

- `s3:ListBucket`

## Input schema fields

- `bucket`
- `region`
- `prefix`
- `delimiter`
- `page_size`
- `cursor`

## Output schema fields

- `objects`
- `objects[]`
- `objects[].key`
- `objects[].size_bytes`
- `objects[].etag`
- `objects[].last_modified_at`
- `objects[].storage_class`
- `common_prefixes`
- `common_prefixes[]`
- `next_cursor`

Provider overview: https://docs.fuse.init.inc/integrations/aws
Actions index: https://docs.fuse.init.inc/integrations/aws/actions
Exact canonical JSON contract: https://docs.fuse.init.inc/api/catalog/v1/providers/aws/actions/s3.objects.list
Deployment-effective discovery: https://api.fuse.init.inc/v1/tenants/%7Btenant_id%7D/providers/aws/actions