v1

latestOpenAPI 3.1.02026-07-26359254.7 MB
Background Jobs

List background jobs

<small>Requires the other:read scope (or a broader one that includes it).</small>

Returns a paginated list of background jobs created by the current user. Optionally filter by category suffix.

get/v3/background-jobs

Query parameters

topinteger

Maximum number of items to return (default 100, max 200)

skipinteger

Number of items to skip

categorystring

Category suffix to filter by — prefix-matched against r2/bg-jobs/{suffix}. For example, pass email-validation to list only email-validation jobs. Omit to list all of the user's background jobs.

Response

Paginated list of background jobs

hasMoreboolean

Whether more items are available beyond the current page