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

Uploads an object to an R2 bucket. The object body is provided as the request body. Returns metadata about the uploaded object.

The maximum upload size for this endpoint is 300 MB. 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
object_key String Yes

Request headers

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

Storage class for this object. Overrides the bucket default.

Valid values:

  • "InfrequentAccess"
  • "Standard"

Default value: "Standard"

Content-Length Integer No
cf-r2-jurisdiction String No

Valid values:

  • "eu"
  • "fedramp"
  • "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.