LogoCloudflare API

R2

r2

R2

Buckets

r2.buckets

Methods

List Buckets -> Envelope<{ buckets }>
get/accounts/{account_id}/r2/buckets

Lists all R2 buckets on your account.

Get Bucket -> Envelope<
Bucket
>
get/accounts/{account_id}/r2/buckets/{bucket_name}

Gets properties of an existing R2 bucket.

Create Bucket -> Envelope<
Bucket
>
post/accounts/{account_id}/r2/buckets

Creates a new R2 bucket.

Patch Bucket -> Envelope<
Bucket
>
patch/accounts/{account_id}/r2/buckets/{bucket_name}

Updates properties of an existing R2 bucket.

Delete Bucket -> Envelope<unknown>
delete/accounts/{account_id}/r2/buckets/{bucket_name}

Deletes an existing R2 bucket.

Domain types

Bucket = { creation_date, jurisdiction, location, 2 more... }

A single R2 bucket.

R2Buckets

CORS

r2.buckets.cors

Methods

Get Bucket CORS Policy -> Envelope<{ rules }>
get/accounts/{account_id}/r2/buckets/{bucket_name}/cors

Get the CORS policy for a bucket.

Put Bucket CORS Policy -> Envelope<unknown>
put/accounts/{account_id}/r2/buckets/{bucket_name}/cors

Set the CORS policy for a bucket.

Delete Bucket CORS Policy -> Envelope<unknown>
delete/accounts/{account_id}/r2/buckets/{bucket_name}/cors

Delete the CORS policy for a bucket.

R2Buckets

Domains

r2.buckets.domains

R2BucketsDomains

Custom

r2.buckets.domains.custom

Methods

List Custom Domains Of Bucket -> Envelope<{ domains }>
get/accounts/{account_id}/r2/buckets/{bucket_name}/domains/custom

Gets a list of all custom domains registered with an existing R2 bucket.

Get Custom Domain Settings -> Envelope<{ domain, enabled, status, 4 more... }>
get/accounts/{account_id}/r2/buckets/{bucket_name}/domains/custom/{domain}

Get the configuration for a custom domain on an existing R2 bucket.

Attach Custom Domain To Bucket -> Envelope<{ domain, enabled, ciphers, 1 more... }>
post/accounts/{account_id}/r2/buckets/{bucket_name}/domains/custom

Register a new custom domain for an existing R2 bucket.

Configure Custom Domain Settings -> Envelope<{ domain, ciphers, enabled, 1 more... }>
put/accounts/{account_id}/r2/buckets/{bucket_name}/domains/custom/{domain}

Edit the configuration for a custom domain on an existing R2 bucket.

Security
API Token

The preferred authorization scheme for interacting with the Cloudflare API. Create a token.

Example: Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY

path Parameters
account_id: string
(maxLength: 32)

Account ID.

bucket_name: string
(maxLength: 64, minLength: 3)

Name of the bucket.

domain: string

Name of the custom domain.

header Parameters
cf-r2-jurisdiction:
Optional
(default: "default")

Jurisdiction where objects in this bucket are guaranteed to be stored.

"default"
"eu"
"fedramp"
Response fields
errors: Array<
ResponseInfo
>
messages: Array<string>
result: { domain, ciphers, enabled, 1 more... }
success: true

Whether the API call was successful.

Request example
200Example
Remove Custom Domain From Bucket -> Envelope<{ domain }>
delete/accounts/{account_id}/r2/buckets/{bucket_name}/domains/custom/{domain}

Remove custom domain registration from an existing R2 bucket.

R2BucketsDomains

Managed

r2.buckets.domains.managed

Methods

Get R2 Dev Domain Of Bucket -> Envelope<{ bucketId, domain, enabled }>
get/accounts/{account_id}/r2/buckets/{bucket_name}/domains/managed

Gets state of public access over the bucket's R2-managed (r2.dev) domain.

Update R2 Dev Domain Of Bucket -> Envelope<{ bucketId, domain, enabled }>
put/accounts/{account_id}/r2/buckets/{bucket_name}/domains/managed

Updates state of public access over the bucket's R2-managed (r2.dev) domain.

R2Buckets

Event Notifications

r2.buckets.event_notifications

Methods

List Event Notification Rules -> Envelope<{ bucketName, queues }>
get/accounts/{account_id}/event_notifications/r2/{bucket_name}/configuration

List all event notification rules for a bucket.

Get Event Notification Rule -> Envelope<{ queueId, queueName, rules }>
get/accounts/{account_id}/event_notifications/r2/{bucket_name}/configuration/queues/{queue_id}

Get a single event notification rule.

Create Event Notification Rule -> Envelope<unknown>
put/accounts/{account_id}/event_notifications/r2/{bucket_name}/configuration/queues/{queue_id}

Create event notification rule.

Delete Event Notification Rules -> Envelope<unknown>
delete/accounts/{account_id}/event_notifications/r2/{bucket_name}/configuration/queues/{queue_id}

Delete an event notification rule. If no body is provided, all rules for specified queue will be deleted.

R2Buckets

Lifecycle

r2.buckets.lifecycle

Methods

Get Object Lifecycle Rules -> Envelope<{ rules }>
get/accounts/{account_id}/r2/buckets/{bucket_name}/lifecycle

Get object lifecycle rules for a bucket.

Put Object Lifecycle Rules -> Envelope<unknown>
put/accounts/{account_id}/r2/buckets/{bucket_name}/lifecycle

Set the object lifecycle rules for a bucket.

R2Buckets

Locks

r2.buckets.locks

Methods

Get Bucket Lock Rules -> Envelope<{ rules }>
get/accounts/{account_id}/r2/buckets/{bucket_name}/lock

Get lock rules for a bucket.

Put Bucket Lock Rules -> Envelope<unknown>
put/accounts/{account_id}/r2/buckets/{bucket_name}/lock

Set lock rules for a bucket.

R2Buckets

Metrics

r2.buckets.metrics

Methods

Get Account Level Metrics -> Envelope<{ infrequentAccess, standard }>
get/accounts/{account_id}/r2/metrics

Get Storage/Object Count Metrics across all buckets in your account. Note that Account-Level Metrics may not immediately reflect the latest data.

R2Buckets

Sippy

r2.buckets.sippy

Methods

Get Sippy Configuration -> Envelope<
Sippy
>
get/accounts/{account_id}/r2/buckets/{bucket_name}/sippy

Gets configuration for Sippy for an existing R2 bucket.

Enable Sippy -> Envelope<
Sippy
>
put/accounts/{account_id}/r2/buckets/{bucket_name}/sippy

Sets configuration for Sippy for an existing R2 bucket.

Disable Sippy -> Envelope<{ enabled }>
delete/accounts/{account_id}/r2/buckets/{bucket_name}/sippy

Disables Sippy on this bucket.

Domain types

Provider = "r2"
Sippy = { destination, enabled, source }
R2

Super Slurper

r2.super_slurper

R2Super Slurper

Connectivity Precheck

r2.super_slurper.connectivity_precheck

Methods

Check Source Connectivity -> Envelope<{ connectivityStatus }>
put/accounts/{account_id}/slurper/source/connectivity-precheck

Check whether tokens are valid against the source bucket

Check Target Connectivity -> Envelope<{ connectivityStatus }>
put/accounts/{account_id}/slurper/target/connectivity-precheck

Check whether tokens are valid against the target bucket

R2Super Slurper

Jobs

r2.super_slurper.jobs

Methods

List Jobs -> SinglePage<{ id, createdAt, finishedAt, 4 more... }>
get/accounts/{account_id}/slurper/jobs

List jobs

Get Job Details -> Envelope<{ id, createdAt, finishedAt, 4 more... }>
get/accounts/{account_id}/slurper/jobs/{job_id}

Get job details

Create A Job -> Envelope<{ id }>
post/accounts/{account_id}/slurper/jobs

Create a job

Abort All Jobs -> Envelope<string>
put/accounts/{account_id}/slurper/jobs/abortAll

Abort all jobs

Abort A Job -> Envelope<string>
put/accounts/{account_id}/slurper/jobs/{job_id}/abort

Abort a job

Pause A Job -> Envelope<string>
put/accounts/{account_id}/slurper/jobs/{job_id}/pause

Pause a job

Get Job Progress -> Envelope<{ id, createdAt, failedObjects, 4 more... }>
get/accounts/{account_id}/slurper/jobs/{job_id}/progress

Get job progress

Resume A Job -> Envelope<string>
put/accounts/{account_id}/slurper/jobs/{job_id}/resume

Resume a job

R2Super SlurperJobs

Logs

r2.super_slurper.jobs.logs

Methods

Get Job Logs -> SinglePage<{ createdAt, job, logType, 2 more... }>
get/accounts/{account_id}/slurper/jobs/{job_id}/logs

Get job logs

R2

Temporary Credentials

r2.temporary_credentials

Methods

Create Temporary Access Credentials -> Envelope<{ accessKeyId, secretAccessKey, sessionToken }>
post/accounts/{account_id}/r2/temp-access-credentials

Creates temporary access credentials on a bucket that can be optionally scoped to prefixes or objects.

Domain types

TemporaryCredential = { bucket, parentAccessKeyId, permission, 3 more... }