DELETE /accounts/{account_id}/r2/buckets/{bucket_name}/objects
Deletes multiple objects from an R2 bucket. Two modes are supported:
- Delete by list (default): Provide a JSON array of object keys in the request body. All listed objects are deleted; per-key errors are reported in the response.
- Delete by prefix: Provide the
prefixquery parameter (and an empty/no body) to schedule deletion of every object whose key begins with the given prefix. This kicks off an asynchronous prefix-delete job and returns the job descriptor.
For most workloads, we recommend using R2's S3-compatible API or a Worker with an R2 binding instead.
Servers
- https://api.cloudflare.com/client/v4
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
bucket_name |
String | Yes | |
account_id |
String | Yes |
Request headers
| Name | Type | Required | Description |
|---|---|---|---|
Content-Type |
String | Yes |
The media type of the request body.
Default value: "application/json" |
cf-r2-jurisdiction |
String | No |
Valid values:
Default value: "default" |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
prefix |
String | No |
Request body fields
| Name | Type | Required | Description |
|---|---|---|---|
[] |
Array | Yes |
How to start integrating
- Add HTTP Task to your workflow definition.
- 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.
- Click Test request to test run your request to the API and see the API's response.