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 ↗
{
{
"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.