Skip to content
ActionCloudflare R2Updated May 2026

How do I list objects in an R2 bucket?

Short answer: Drop the "Cloudflare R2List 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.

FieldTypeRequiredDescription
Bucket
bucket
stringRequiredmy-bucket
Prefix
prefix
stringOptionalFilter by key prefix, e.g. `uploads/2026/`.
Max Keys
max_keys
numberOptionalMax 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.

Send list r2 objects from your workflows.

Triggered by anything in the catalog. Free tier available. No credit card.