# AWS S3 - Workflow node | Docs - nodulz

Source: https://nodulz.com/docs/nodes/aws_s3

Language: en

Buckets, files and folders on Amazon S3

## Usage and specifics

Folders are object prefixes, not ordinary directories. Set bucket and key for the operation. delete_folder removes objects under the prefix; a presigned URL grants temporary access.

Technical type : `aws_s3`. Runtime : `nodulz`.

## Credentials and prerequisites

- [Create and configure the credential : aws](/docs/credentials/aws)

Create credentials in your nodulz instance’s Credentials area, then select them on the node. Availability depends on ownership and sharing. See the [credentials guide](/docs/credentials) for access and rotation.

## Parameters

Names below are technical keys. Defaults are not a ready-to-run configuration: complete fields required by your operation. Paths containing [] describe list items; some fields depend on the selected mode.

| Parameter | Type | Default | Values / limits |
| --- | --- | --- | --- |
| `credentialId` | `string` | - | - |
| `serviceInstanceId` | `string` | - | - |
| `connectionSource` | `enum` | `"credential"` | `credential`, `service` |
| `operation` | `enum` | `"upload_file"` | `create_bucket`, `delete_bucket`, `list_buckets`, `search_bucket`, `copy_file`, `delete_file`, `download_file`, `presign_url`, `list_files`, `upload_file`, `create_folder`, `delete_folder`, `list_folders` |
| `bucket` | `string` | `""` | - |
| `key` | `string` | `""` | - |
| `sourceKey` | `string` | `""` | - |
| `destKey` | `string` | `""` | - |
| `prefix` | `string` | `""` | - |
| `content` | `string` | `""` | - |
| `encoding` | `enum` | `"base64"` | `utf8`, `base64` |
| `contentType` | `string` | `""` | - |
| `metadata` | `string` | `""` | - |
| `maxKeys` | `number` | `100` | -; ≥ 1, ≤ 1000 |
| `searchName` | `string` | `""` | - |

## Configuration help

| Setting | Purpose and guidance |
| --- | --- |
| `credentialId`<br>Storage credential | Access keys and endpoint are stored on the Credentials page. |
| `searchName`<br>Search name | Exact bucket name or substring to match when searching. |
| `bucket`<br>Bucket | Bucket name (lowercase). Supports workflow expressions. |
| `key`<br>Object key | Path to the object inside the bucket (e.g. folder/file.txt). |
| `sourceKey`<br>Source key | Key of the object to copy. |
| `destKey`<br>Destination key | Target key for the copy. |
| `prefix`<br>Prefix | Key prefix for listing or deleting a folder tree. |
| `encoding`<br>Encoding | How content is interpreted before upload. |
| `content`<br>Content | File body (UTF-8 or base64 depending on encoding). |
| `contentType`<br>Content type | Optional MIME type (e.g. application/pdf). |
| `metadata`<br>Metadata (JSON) | Optional user metadata object (string values only). |
| `maxKeys`<br>Max keys | Maximum objects returned per list request (1–1000). |

## Initial configuration

Initial catalog configuration example, to adapt before running. Keep secrets in credentials.

```json
{
  "connectionSource": "credential",
  "operation": "upload_file",
  "bucket": "",
  "key": "",
  "sourceKey": "",
  "destKey": "",
  "prefix": "",
  "content": "",
  "encoding": "base64",
  "contentType": "",
  "metadata": "",
  "maxKeys": 100,
  "searchName": ""
}
```

## Verification

Test with representative data. Check node output in the inspector and logs, then use editor mapping for downstream fields. A trigger test with a simulated payload does not validate external service delivery.

See also : [Expressions and data](/docs/expressions), [Executions](/docs/executions), [Node catalog](/docs/nodes).

## Explore further

- [Features - nodulz](https://nodulz.com/product/overview)
- [Node catalog - nodulz](https://nodulz.com/product/catalog)
- [MCP server - nodulz](https://nodulz.com/product/mcp)
- [Pricing - nodulz](https://nodulz.com/pricing)
- [Use cases and workflow automation - nodulz](https://nodulz.com/use-cases)
- [Choose what your workflows can do. - nodulz](https://nodulz.com/compare)
- [Documentation - nodulz](https://nodulz.com/docs)