- Integrations
- /
- Cloudflare R2
- /
- Actions
- /
- List R2 Objects
ActionCloudflare R2Updated May 2026
How do I list objects in an R2 bucket?
Short answer: Drop the "Cloudflare R2 → List R2 Objects" action anywhere in your workflow, map the inputs from upstream nodes, and publish.
Inputs
The fields this action accepts.
Every field can be mapped from an upstream trigger, AI step, table row, or hard-coded literal.
| Field | Type | Required | Description |
|---|---|---|---|
Bucket bucket | string | Required | my-bucket |
Prefix prefix | string | Optional | Filter by key prefix, e.g. `uploads/2026/`. |
Max Keys max_keys | number | Optional | Max objects to return (1-1000). |
Sample request
{"bucket": "my-bucket","prefix": "{{trigger.prefix}}","max_keys": "{{trigger.max_keys}}"}
Returns
"<ListBucketResult>...</ListBucketResult>"
Use these fields in downstream nodes for routing, logging, or error handling.
Triggered by
Apps that pair well as the trigger for List R2 Objects.
Any of these apps can fire this action as part of a workflow.
FAQ
Questions about List R2 Objects.
What does the List R2 Objects action do in Cloudflare R2?
Paginated objects within a bucket with optional prefix filter. Useful for batch-processing workflows that need to discover all objects matching a pattern (e.g., "all .csv files under exports/" for incremental ingestion).
What inputs does List R2 Objects require?
Required: Bucket. Every input accepts a static value or a variable from any upstream node in your workflow.
Can I use dynamic inputs from earlier workflow nodes?
Yes. Any field on this action can pull values from upstream nodes, whether that's a form response, a trigger payload, an AI output, or a lookup result.
What happens if Cloudflare R2 returns an error?
The workflow pauses on the failed node, the error message is captured in the run log, and you can retry the run with one click. Auto-retry policies are configurable per workflow with exponential backoff up to 5 attempts.
Does List R2 Objects support batch operations?
Yes. Run List R2 Objects inside a Loop node to process arrays. Tiny Command handles Cloudflare R2's rate limits automatically so you don't have to throttle manually.
More actions
Other Cloudflare R2 actions.
Action
Get R2 Object
Downloads object content from an R2 bucket. For workflows that need to fetch and process R2-stored content (CDN-origin files, archived backups, user-uploaded assets) downstream.
ActionList R2 Buckets
Returns every R2 bucket in the account with name and creation date. Useful for bucket-inventory workflows and for resolving bucket names at workflow-build time.
Send list r2 objects from your workflows.
Triggered by anything in the catalog. Free tier available. No credit card.