GET /accounts/{account_id}/r2/buckets/{bucket_name}/objects

Lists objects in an R2 bucket. Returns object metadata including key, size, etag, last modified date, HTTP metadata, and custom metadata.

For most workloads, we recommend using R2's S3-compatible API or a Worker with an R2 binding instead.

Servers

Path parameters

Name Type Required Description
bucket_name String Yes
account_id String Yes

Request headers

Name Type Required Description
cf-r2-jurisdiction String No

Valid values:

  • "eu"
  • "fedramp"
  • "default"

Default value: "default"

Query parameters

Name Type Required Description
prefix String No
per_page Integer No

Default value: 20

start_after String No
delimiter String No
cursor String No

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.