PUT /accounts/{account_id}/r2/buckets/{bucket_name}

Creates a new R2 bucket using the name from the URL path. Similar to r2-create-bucket (POST), but the bucket name comes from the path and the optional storage class is supplied via the cf-r2-storage-class header. There is no request body. Unlike the POST variant, this endpoint does not accept a location hint — the bucket is placed in the R2 region for the caller's edge colo. Use the POST variant if you need to set a locationHint.

Servers

Path parameters

Name Type Required Description
bucket_name String Yes
account_id String Yes

Request headers

Name Type Required Description
cf-r2-storage-class String No

Valid values:

  • "InfrequentAccess"
  • "Standard"

Default value: "Standard"

cf-r2-jurisdiction String No

Valid values:

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

Default value: "default"

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.