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

Lists background jobs for an R2 bucket. Use this endpoint to poll jobs returned by asynchronous operations such as deleting objects by prefix or emptying a bucket.

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

Name	Type	Required	Description
`cf-r2-jurisdiction`	String	No	Valid values: `"eu"` `"fedramp"` `"us"` `"default"` Default value: "default"

cf-r2-jurisdiction

String

Valid values:

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

Default value: "default"

Query parameters

Name	Type	Required	Description
`maxKeys`	Integer	No	Maximum number of jobs to return.
`jobType`	String	No	Restricts results to jobs of the specified type. Valid values: `"prefixDelete"`
`status`	String	No	Restricts results to jobs with the specified status. `jobType` is required when this parameter is provided. Valid values: `"ENQUEUED"` `"RUNNING"` `"CANCELLED"` `"FAILED"` `"COMPLETED"`
`continuationToken`	String	No	Pagination token received as `nextContinuationToken` in the previous response.

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.