detektu
Cloudflare API changes
Info

Endpoint added: POST /accounts/{}/r2/buckets/{}/jobs

openapi:POST /accounts/{}/r2/buckets/{}/jobs::operation.endpoint-added
Product
Cloudflare API
Source
Repository Spec
Change kind
Endpoint Added
Detected
Last updated

Deterministic evidence

Before / after

Extracted from Cloudflare's published contract. Shows the whole path item — a narrower excerpt was not available for this change. Open the source ↗

−108+1509 changes

1 / 9
{
{
"get": {
"operationId": "r2-create-bucket-job",
"operationId": "r2-list-bucket-jobs",
"parameters": [
"parameters": [
{
{
"in": "path",
"in": "path",
"name": "account_id",
"name": "account_id",
"required": true,
"required": true,
"schema": {
"schema": {
"$ref": "#/components/schemas/r2_account_identifier"
"$ref": "#/components/schemas/r2_account_identifier"
}
},
{
"in": "path",
"name": "bucket_name",
"required": true,
"schema": {
"$ref": "#/components/schemas/r2_bucket_name"
}
},
{
"$ref": "#/components/parameters/r2_cf-r2-jurisdiction"
},
{
"in": "query",
"name": "jobType",
"schema": {
"enum": [
"prefixDelete",
"storageClassMigration"
],
"type": "string"
}
},
{
"in": "query",
"name": "status",
"schema": {
"$ref": "#/components/schemas/r2_r2_bucket_job_status"
}
},
{
"in": "query",
"name": "maxKeys",
"schema": {
"maximum": 1000,
"minimum": 0,
"type": "integer"
}
},
{
"in": "query",
"name": "continuationToken",
"schema": {
"type": "string"
}
}
}
],
},
"responses": {
{
"200": {
"in": "path",
"content": {
"name": "bucket_name",
"application/json": {
"required": true,
"schema": {
"schema": {
"allOf": [
"$ref": "#/components/schemas/r2_bucket_name"
{
}
"$ref": "#/components/schemas/r2_v4_response"
},
{
"$ref": "#/components/parameters/r2_cf-r2-jurisdiction"
},
{
"in": "header",
"name": "cf-r2-data-catalog-check",
"schema": {
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"discriminator": {
"mapping": {
"prefixDelete": "#/components/schemas/r2_create_prefix_delete_job_request",
"storageClassMigration": "#/components/schemas/r2_create_storage_class_migration_job_request"
},
"propertyName": "jobType"
},
"oneOf": [
{
"additionalProperties": false,
"properties": {
"jobType": {
"enum": [
"prefixDelete"
],
"type": "string"
},
},
{
"prefix": {
"properties": {
"type": "string"
"result": {
"properties": {
"jobs": {
"items": {
"$ref": "#/components/schemas/r2_r2_bucket_job"
},
"type": "array"
},
"nextContinuationToken": {
"type": "string"
}
},
"required": [
"jobs"
],
"type": "object"
}
},
"type": "object"
}
}
]
},
"required": [
"jobType",
"prefix"
],
"title": "Prefix Delete Job",
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"destinationStorageClass": {
"enum": [
"Standard",
"InfrequentAccess"
],
"type": "string"
},
"jobType": {
"enum": [
"storageClassMigration"
],
"type": "string"
},
"sourceStorageClass": {
"enum": [
"Standard",
"InfrequentAccess"
],
"type": "string"
}
},
"required": [
"jobType"
],
"title": "Storage Class Migration Job",
"type": "object"
}
}
]
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/r2_v4_response"
},
{
"properties": {
"result": {
"$ref": "#/components/schemas/r2_r2_bucket_job"
}
},
"type": "object"
}
]
}
}
}
}
},
}
"4XX": {
},
"content": {
"409": {
"application/json": {
"content": {
"schema": {
"application/json": {
"$ref": "#/components/schemas/r2_v4_response_failure"
"schema": {
}
"$ref": "#/components/schemas/r2_v4_response_failure"
}
}
}
}
}
}
},
},
"security": [
"429": {
{
"content": {
"api_token": []
"application/json": {
"schema": {
"$ref": "#/components/schemas/r2_v4_response_failure"
}
}
}
}
],
"tags": [
"R2 Bucket"
],
"x-cfPermissionsRequired": {
"enum": [
"com.cloudflare.edge.r2.bucket.read"
]
},
},
"x-fern-availability": "generally-available",
"4XX": {
"x-fern-sdk-group-name": "r2.buckets.jobs",
"content": {
"x-fern-sdk-method-name": "list"
"application/json": {
}
"schema": {
"$ref": "#/components/schemas/r2_v4_response_failure"
}
}
}
}
},
"security": [
{
"api_token": []
}
],
"tags": [
"R2 Bucket"
],
"x-api-token-group": [
"Workers R2 Storage Write"
],
"x-fern-availability": "generally-available",
"x-fern-sdk-group-name": "r2.buckets.jobs",
"x-fern-sdk-method-name": "create",
"x-forge-require-confirmation": "This starts a background job that either permanently deletes every object under the given prefix (every object in the bucket for an empty prefix) or migrates every object in the bucket between storage classes."
}
}

Monitored for you

Does this change affect your integration?

Choose the operations and fields your services use. detektu matches Cloudflare findings to that declared usage so your team can review the relevant evidence. No agent or repository access required.