Skip to content

Cloudflare R2

Updated View as Markdown

Creates and manages buckets, objects, Data Catalogs, domains and rules, and reads object contents.

What you can do (46)

What you can do

Available commands: 46 (23 read, 23 write). Enable only the commands your application needs.

Command Effect
Browse buckets — r2.listBuckets Read
Browse Data Catalogs — r2.listCatalogs Read
Read usage metrics — r2.metrics Read
Read bucket — r2.getBucket Read
Read CORS — r2.getBucketCorsPolicy Read
Read Data Catalog — r2.getCatalog Read
Read Catalog maintenance settings — r2.getCatalogMaintenanceConfig Read
Read lifecycle rules — r2.getLifecycleRules Read
Read lock rules — r2.getLockRules Read
Read hosted domain — r2.getManagedDomain Read
Read Sippy configuration — r2.getSippy Read
Browse custom domains — r2.listCustomDomains Read
Browse event notifications — r2.listEventNotificationRules Read
Browse namespaces — r2.listNamespaces Read
Browse objects — r2.listObjects Read
Read object — r2.getObject Read
Browse tables — r2.listTables Read
Create bucket — r2.createBucket Write
Delete bucket — r2.deleteBucket Write
Upload object — r2.putObject Write
Delete object — r2.deleteObject Write
Read a custom domain — r2.getCustomDomain Read
Read an event notification rule — r2.getEventNotificationRule Read
Read a migration job — r2.getSlurperJob Read
Read migration job logs — r2.getSlurperJobLogs Read
Read migration job progress — r2.getSlurperJobProgress Read
Read table maintenance settings — r2.getTableMaintenanceConfig Read
Attach a custom domain — r2.attachCustomDomain Write
Update a custom domain — r2.configureCustomDomain Write
Remove a custom domain — r2.removeCustomDomain Write
Create an event notification rule — r2.createEventNotificationRule Write
Delete an event notification rule — r2.deleteEventNotificationRule Write
Pause a migration job — r2.pauseSlurperJob Write
Resume a migration job — r2.resumeSlurperJob Write
Abort a migration job — r2.abortSlurperJob Write
Change bucket storage class — r2.patchBucket Write
Replace the CORS policy — r2.putBucketCorsPolicy Write
Delete the CORS policy — r2.deleteBucketCorsPolicy Write
Replace lifecycle rules — r2.putLifecycleRules Write
Replace object lock rules — r2.putLockRules Write
Enable the Data Catalog — r2.enableCatalog Write
Disable the Data Catalog — r2.disableCatalog Write
Disable Sippy migration — r2.disableSippy Write
Update the hosted domain — r2.updateManagedDomain Write
Update Catalog maintenance settings — r2.updateCatalogMaintenanceConfig Write
Update table maintenance settings — r2.updateTableMaintenanceConfig Write

Connect and use

Connect and use

Open the integration's connection form to check the available credential source. The source has not been resolved for this documentation export. The instructions below apply when using your own provider account.

Get your provider credentials

Follow these steps for Cloudflare R2, then enter the issued values in the connection form below.

  1. In Cloudflare My Profile → API Tokens → Create Token, create a custom token for the target account and product: Images, URL Scanner or R2. Grant only the read/edit permissions needed by your commands. Enter the token and dashboard Account ID. An R2 S3 access key is not a Cloudflare management API token.

Official credential setup

Where to enter credentials

In the integration page, sign in, choose your workspace and open Connect. If a Credentials choice is shown, select Use my credentials. Fill the following connection fields and save. Provider credentials belong in this form, never in an MCP configuration or tool input.

Connection field Requirement
OAuth client id Required
OAuth client secret Required
API token (optional: use this instead of signing in) Optional
Cloudflare Account ID (optional) Optional

Open API keys and create a Tooluse.net key for the enabled commands.

Set TOOLUSE_API_KEY in your client and use the shared MCP configuration.

Configure Claude Code, Codex or Cursor once

Permissions and results

If you have more than one workspace, check the selected workspace in the connection or API-key dialog before saving. Roles, enabled commands, expiry and revocation use Tooluse.net's existing permissions. Disabling a connection or revoking a key immediately prevents new calls.

Send one Claude tool_use block per request. Keep the same Idempotency-Key when retrying the same request; use a new key for a new call. The response includes the shared Tooluse.net receipt and Claude tool_result. Check both HTTP status and the returned tool result before treating a call as successful.

Your connection's daily allowance and key permissions also apply. Adding a connection does not make a provider request.

Calls return the shared execution receipt and a Claude tool_result. Provider output varies by operation; consult the provider documentation for its response fields. Unconfirmed calls should be checked before retrying.

Call from your client

Use the shared MCP configuration. Refresh your client's tool list after saving the connection or changing key permissions, then call the returned tool name with the example input below.

Configure Claude Code, Codex or Cursor once

Discover your enabled tools

List permitted tools in Claude format. Read every page using page and size (maximum 100) until all results have been received. Use the returned name, not a catalog capability identifier, in the tool_use block.

curl 'https://api.tooluse.net/v1/tools' \
  -H "Authorization: Bearer $TOOLUSE_API_KEY"

Find this command in the tool list permitted by your key. Replace svc_FROM_YOUR_TOOL_LIST with its returned name. Use a new Idempotency-Key for each new call and retain it when retrying that same call.

HTTP call

curl 'https://api.tooluse.net/v1/tool-calls' \
  -H "Authorization: Bearer $TOOLUSE_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: replace-with-a-new-call-id' \
  --data '{
  "type": "tool_use",
  "id": "toolu_example",
  "name": "svc_FROM_YOUR_TOOL_LIST",
  "input": {
    "limit": 50
  }
}'

Send one Claude tool_use block per request. Keep the same Idempotency-Key when retrying the same request; use a new key for a new call. The response includes the shared Tooluse.net receipt and Claude tool_result. Check both HTTP status and the returned tool result before treating a call as successful.

Commands

Browse buckets — r2.listBuckets

Run Browse buckets with Cloudflare R2. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
limit integer Optional Buckets per page minimum: 1; maximum: 1000
cursor string Optional Next page cursor minLength: 1; maxLength: 2000
nameContains string Optional Bucket name contains minLength: 1; maxLength: 2000
startAfter string Optional Start after bucket name minLength: 1; maxLength: 2000
direction string Optional Sort direction enum: ["asc","desc"]

Full JSON Schema

Full JSON Schema

Example input

{
  "limit": 50
}

At most 3 provider requests per invocation; timeout: 30 seconds.

Browse Data Catalogs — r2.listCatalogs

Run Browse Data Catalogs with Cloudflare R2. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

This tool has no input parameters.

Full JSON Schema

Full JSON Schema

Example input

{}

At most 3 provider requests per invocation; timeout: 30 seconds.

Read usage metrics — r2.metrics

Run Read usage metrics with Cloudflare R2. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

This tool has no input parameters.

Full JSON Schema

Full JSON Schema

Example input

{}

At most 3 provider requests per invocation; timeout: 30 seconds.

Read bucket — r2.getBucket

Run Read bucket with Cloudflare R2. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
bucketName string Required Bucket name minLength: 1; maxLength: 2000; pattern: "^[a-z0-9][a-z0-9-]{1,61}[a-z0-9]$"

Full JSON Schema

Full JSON Schema

Example input

{
  "bucketName": "example-bucket"
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Read CORS — r2.getBucketCorsPolicy

Run Read CORS with Cloudflare R2. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
bucketName string Required Bucket name minLength: 1; maxLength: 2000; pattern: "^[a-z0-9][a-z0-9-]{1,61}[a-z0-9]$"

Full JSON Schema

Full JSON Schema

Example input

{
  "bucketName": "example-bucket"
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Read Data Catalog — r2.getCatalog

Run Read Data Catalog with Cloudflare R2. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
bucketName string Required Bucket name minLength: 1; maxLength: 2000; pattern: "^[a-z0-9][a-z0-9-]{1,61}[a-z0-9]$"

Full JSON Schema

Full JSON Schema

Example input

{
  "bucketName": "example-bucket"
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Read Catalog maintenance settings — r2.getCatalogMaintenanceConfig

Run Read Catalog maintenance settings with Cloudflare R2. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
bucketName string Required Bucket name minLength: 1; maxLength: 2000; pattern: "^[a-z0-9][a-z0-9-]{1,61}[a-z0-9]$"

Full JSON Schema

Full JSON Schema

Example input

{
  "bucketName": "example-bucket"
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Read lifecycle rules — r2.getLifecycleRules

Run Read lifecycle rules with Cloudflare R2. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
bucketName string Required Bucket name minLength: 1; maxLength: 2000; pattern: "^[a-z0-9][a-z0-9-]{1,61}[a-z0-9]$"

Full JSON Schema

Full JSON Schema

Example input

{
  "bucketName": "example-bucket"
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Read lock rules — r2.getLockRules

Run Read lock rules with Cloudflare R2. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
bucketName string Required Bucket name minLength: 1; maxLength: 2000; pattern: "^[a-z0-9][a-z0-9-]{1,61}[a-z0-9]$"

Full JSON Schema

Full JSON Schema

Example input

{
  "bucketName": "example-bucket"
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Read hosted domain — r2.getManagedDomain

Run Read hosted domain with Cloudflare R2. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
bucketName string Required Bucket name minLength: 1; maxLength: 2000; pattern: "^[a-z0-9][a-z0-9-]{1,61}[a-z0-9]$"

Full JSON Schema

Full JSON Schema

Example input

{
  "bucketName": "example-bucket"
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Read Sippy configuration — r2.getSippy

Run Read Sippy configuration with Cloudflare R2. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
bucketName string Required Bucket name minLength: 1; maxLength: 2000; pattern: "^[a-z0-9][a-z0-9-]{1,61}[a-z0-9]$"

Full JSON Schema

Full JSON Schema

Example input

{
  "bucketName": "example-bucket"
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Browse custom domains — r2.listCustomDomains

Run Browse custom domains with Cloudflare R2. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
bucketName string Required Bucket name minLength: 1; maxLength: 2000; pattern: "^[a-z0-9][a-z0-9-]{1,61}[a-z0-9]$"

Full JSON Schema

Full JSON Schema

Example input

{
  "bucketName": "example-bucket"
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Browse event notifications — r2.listEventNotificationRules

Run Browse event notifications with Cloudflare R2. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
bucketName string Required Bucket name minLength: 1; maxLength: 2000; pattern: "^[a-z0-9][a-z0-9-]{1,61}[a-z0-9]$"

Full JSON Schema

Full JSON Schema

Example input

{
  "bucketName": "example-bucket"
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Browse namespaces — r2.listNamespaces

Run Browse namespaces with Cloudflare R2. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
bucketName string Required Bucket name minLength: 1; maxLength: 2000; pattern: "^[a-z0-9][a-z0-9-]{1,61}[a-z0-9]$"
limit integer Optional Namespaces per page minimum: 1; maximum: 1000
pageToken string Optional Next page token minLength: 1; maxLength: 2000
parent array Optional Parent namespace path minItems: 1; maxItems: 20; uniqueItems: true
parent[] string Optional Namespace segment minLength: 1; maxLength: 2000
returnDetails boolean Optional Include details
returnUuids boolean Optional Include UUIDs

Full JSON Schema

Full JSON Schema

Example input

{
  "bucketName": "example-bucket"
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Browse objects — r2.listObjects

Run Browse objects with Cloudflare R2. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
bucketName string Required Bucket name minLength: 1; maxLength: 2000; pattern: "^[a-z0-9][a-z0-9-]{1,61}[a-z0-9]$"
prefix string Optional Prefix minLength: 0; maxLength: 2000
cursor string Optional Next page cursor minLength: 1; maxLength: 2000
limit integer Optional Items per page minimum: 1; maximum: 100
delimiter string Optional Path delimiter minLength: 1; maxLength: 20
startAfter string Optional Start after object key minLength: 1; maxLength: 2000

Full JSON Schema

Full JSON Schema

Example input

{
  "bucketName": "example-bucket",
  "limit": 20
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Read object — r2.getObject

Run Read object with Cloudflare R2. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
bucketName string Required Bucket name minLength: 1; maxLength: 2000; pattern: "^[a-z0-9][a-z0-9-]{1,61}[a-z0-9]$"
objectKey string Required Object key minLength: 1; maxLength: 2000

Full JSON Schema

Full JSON Schema

Example input

{
  "bucketName": "example-bucket",
  "objectKey": "document.txt"
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Browse tables — r2.listTables

Run Browse tables with Cloudflare R2. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
bucketName string Required Bucket name minLength: 1; maxLength: 2000; pattern: "^[a-z0-9][a-z0-9-]{1,61}[a-z0-9]$"
namespace string Required Namespace minLength: 1; maxLength: 2000
limit integer Optional Tables per page minimum: 1; maximum: 1000
pageToken string Optional Next page token minLength: 1; maxLength: 2000
returnDetails boolean Optional Include details
returnUuids boolean Optional Include UUIDs

Full JSON Schema

Full JSON Schema

Example input

{
  "bucketName": "example-bucket",
  "namespace": "default"
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create bucket — r2.createBucket

Run Create bucket with Cloudflare R2. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
bucketName string Required Bucket name minLength: 1; maxLength: 2000; pattern: "^[a-z0-9][a-z0-9-]{1,61}[a-z0-9]$"
locationHint string Optional Location hint enum: ["apac","eeur","enam","weur","wnam","oc"]
storageClass string Optional Storage class enum: ["Standard","InfrequentAccess"]

Full JSON Schema

Full JSON Schema

Example input

{
  "bucketName": "agent-artifacts"
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete bucket — r2.deleteBucket

Run Delete bucket with Cloudflare R2. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
bucketName string Required Bucket name minLength: 1; maxLength: 2000; pattern: "^[a-z0-9][a-z0-9-]{1,61}[a-z0-9]$"

Full JSON Schema

Full JSON Schema

Example input

{
  "bucketName": "example-bucket"
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Upload object — r2.putObject

Run Upload object with Cloudflare R2. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
bucketName string Required Bucket name minLength: 1; maxLength: 2000; pattern: "^[a-z0-9][a-z0-9-]{1,61}[a-z0-9]$"
objectKey string Required Object key minLength: 1; maxLength: 2000
content string Required Object content minLength: 0; maxLength: 1000000
contentType string Optional Content type minLength: 1; maxLength: 255

Full JSON Schema

Full JSON Schema

Example input

{
  "bucketName": "example-bucket",
  "objectKey": "notes/hello.txt",
  "content": "hello",
  "contentType": "text/plain"
}

At most 1 provider requests per invocation; timeout: 60 seconds.

Delete object — r2.deleteObject

Run Delete object with Cloudflare R2. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
bucketName string Required Bucket name minLength: 1; maxLength: 2000; pattern: "^[a-z0-9][a-z0-9-]{1,61}[a-z0-9]$"
objectKey string Required Object key minLength: 1; maxLength: 2000

Full JSON Schema

Full JSON Schema

Example input

{
  "bucketName": "example-bucket",
  "objectKey": "notes/hello.txt"
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Read a custom domain — r2.getCustomDomain

Run Read a custom domain with Cloudflare R2. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
bucketName string Required Bucket name minLength: 1; maxLength: 2000; pattern: "^[a-z0-9][a-z0-9-]{1,61}[a-z0-9]$"
domain string Required Custom domain minLength: 1; maxLength: 2000; pattern: "^[A-Za-z0-9.-]{1,253}$"

Full JSON Schema

Full JSON Schema

Example input

{
  "bucketName": "example-bucket",
  "domain": "assets.example.com"
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Read an event notification rule — r2.getEventNotificationRule

Run Read an event notification rule with Cloudflare R2. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
bucketName string Required Bucket name minLength: 1; maxLength: 2000; pattern: "^[a-z0-9][a-z0-9-]{1,61}[a-z0-9]$"
queueId string Required Queue ID minLength: 1; maxLength: 2000

Full JSON Schema

Full JSON Schema

Example input

{
  "bucketName": "example-bucket",
  "queueId": "queue-123"
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Read a migration job — r2.getSlurperJob

Run Read a migration job with Cloudflare R2. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
jobId string Required Migration job ID minLength: 1; maxLength: 2000

Full JSON Schema

Full JSON Schema

Example input

{
  "jobId": "job-123"
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Read migration job logs — r2.getSlurperJobLogs

Run Read migration job logs with Cloudflare R2. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
jobId string Required Migration job ID minLength: 1; maxLength: 2000
limit integer Optional Log entries minimum: 1; maximum: 100

Full JSON Schema

Full JSON Schema

Example input

{
  "jobId": "job-123",
  "limit": 20
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Read migration job progress — r2.getSlurperJobProgress

Run Read migration job progress with Cloudflare R2. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
jobId string Required Migration job ID minLength: 1; maxLength: 2000

Full JSON Schema

Full JSON Schema

Example input

{
  "jobId": "job-123"
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Read table maintenance settings — r2.getTableMaintenanceConfig

Run Read table maintenance settings with Cloudflare R2. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
bucketName string Required Bucket name minLength: 1; maxLength: 2000; pattern: "^[a-z0-9][a-z0-9-]{1,61}[a-z0-9]$"
namespace string Required Namespace minLength: 1; maxLength: 2000
tableName string Required Table name minLength: 1; maxLength: 2000

Full JSON Schema

Full JSON Schema

Example input

{
  "bucketName": "example-bucket",
  "namespace": "default",
  "tableName": "events"
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Attach a custom domain — r2.attachCustomDomain

Run Attach a custom domain with Cloudflare R2. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
bucketName string Required Bucket name minLength: 1; maxLength: 2000; pattern: "^[a-z0-9][a-z0-9-]{1,61}[a-z0-9]$"
configurationJson string Required Cloudflare custom-domain configuration (JSON object) minLength: 1; maxLength: 64000

Full JSON Schema

Full JSON Schema

Example input

{
  "bucketName": "example-bucket",
  "configurationJson": "{\"domain\":\"assets.example.com\"}"
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update a custom domain — r2.configureCustomDomain

Run Update a custom domain with Cloudflare R2. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
bucketName string Required Bucket name minLength: 1; maxLength: 2000; pattern: "^[a-z0-9][a-z0-9-]{1,61}[a-z0-9]$"
domain string Required Custom domain minLength: 1; maxLength: 2000; pattern: "^[A-Za-z0-9.-]{1,253}$"
configurationJson string Required Cloudflare custom-domain configuration (JSON object) minLength: 1; maxLength: 64000

Full JSON Schema

Full JSON Schema

Example input

{
  "bucketName": "example-bucket",
  "domain": "assets.example.com",
  "configurationJson": "{\"enabled\":true}"
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Remove a custom domain — r2.removeCustomDomain

Run Remove a custom domain with Cloudflare R2. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
bucketName string Required Bucket name minLength: 1; maxLength: 2000; pattern: "^[a-z0-9][a-z0-9-]{1,61}[a-z0-9]$"
domain string Required Custom domain minLength: 1; maxLength: 2000; pattern: "^[A-Za-z0-9.-]{1,253}$"

Full JSON Schema

Full JSON Schema

Example input

{
  "bucketName": "example-bucket",
  "domain": "assets.example.com"
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create an event notification rule — r2.createEventNotificationRule

Run Create an event notification rule with Cloudflare R2. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
bucketName string Required Bucket name minLength: 1; maxLength: 2000; pattern: "^[a-z0-9][a-z0-9-]{1,61}[a-z0-9]$"
queueId string Required Queue ID minLength: 1; maxLength: 2000
configurationJson string Required Event notification rule (JSON object) minLength: 1; maxLength: 64000

Full JSON Schema

Full JSON Schema

Example input

{
  "bucketName": "example-bucket",
  "queueId": "queue-123",
  "configurationJson": "{\"rules\":[{\"actions\":[\"PutObject\"],\"prefix\":\"incoming/\"}]}"
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete an event notification rule — r2.deleteEventNotificationRule

Run Delete an event notification rule with Cloudflare R2. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
bucketName string Required Bucket name minLength: 1; maxLength: 2000; pattern: "^[a-z0-9][a-z0-9-]{1,61}[a-z0-9]$"
queueId string Required Queue ID minLength: 1; maxLength: 2000

Full JSON Schema

Full JSON Schema

Example input

{
  "bucketName": "example-bucket",
  "queueId": "queue-123"
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Pause a migration job — r2.pauseSlurperJob

Run Pause a migration job with Cloudflare R2. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
jobId string Required Migration job ID minLength: 1; maxLength: 2000

Full JSON Schema

Full JSON Schema

Example input

{
  "jobId": "job-123"
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Resume a migration job — r2.resumeSlurperJob

Run Resume a migration job with Cloudflare R2. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
jobId string Required Migration job ID minLength: 1; maxLength: 2000

Full JSON Schema

Full JSON Schema

Example input

{
  "jobId": "job-123"
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Abort a migration job — r2.abortSlurperJob

Run Abort a migration job with Cloudflare R2. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
jobId string Required Migration job ID minLength: 1; maxLength: 2000

Full JSON Schema

Full JSON Schema

Example input

{
  "jobId": "job-123"
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Change bucket storage class — r2.patchBucket

Run Change bucket storage class with Cloudflare R2. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
bucketName string Required Bucket name minLength: 1; maxLength: 2000; pattern: "^[a-z0-9][a-z0-9-]{1,61}[a-z0-9]$"
storageClass string Required Storage class enum: ["Standard","InfrequentAccess"]

Full JSON Schema

Full JSON Schema

Example input

{
  "bucketName": "example-bucket",
  "storageClass": "Standard"
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Replace the CORS policy — r2.putBucketCorsPolicy

Run Replace the CORS policy with Cloudflare R2. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
bucketName string Required Bucket name minLength: 1; maxLength: 2000; pattern: "^[a-z0-9][a-z0-9-]{1,61}[a-z0-9]$"
configurationJson string Required CORS policy (JSON object) minLength: 1; maxLength: 64000

Full JSON Schema

Full JSON Schema

Example input

{
  "bucketName": "example-bucket",
  "configurationJson": "{\"rules\":[]}"
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete the CORS policy — r2.deleteBucketCorsPolicy

Run Delete the CORS policy with Cloudflare R2. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
bucketName string Required Bucket name minLength: 1; maxLength: 2000; pattern: "^[a-z0-9][a-z0-9-]{1,61}[a-z0-9]$"

Full JSON Schema

Full JSON Schema

Example input

{
  "bucketName": "example-bucket"
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Replace lifecycle rules — r2.putLifecycleRules

Run Replace lifecycle rules with Cloudflare R2. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
bucketName string Required Bucket name minLength: 1; maxLength: 2000; pattern: "^[a-z0-9][a-z0-9-]{1,61}[a-z0-9]$"
configurationJson string Required Lifecycle rules (JSON object) minLength: 1; maxLength: 64000

Full JSON Schema

Full JSON Schema

Example input

{
  "bucketName": "example-bucket",
  "configurationJson": "{\"rules\":[]}"
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Replace object lock rules — r2.putLockRules

Run Replace object lock rules with Cloudflare R2. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
bucketName string Required Bucket name minLength: 1; maxLength: 2000; pattern: "^[a-z0-9][a-z0-9-]{1,61}[a-z0-9]$"
configurationJson string Required Object lock rules (JSON object) minLength: 1; maxLength: 64000

Full JSON Schema

Full JSON Schema

Example input

{
  "bucketName": "example-bucket",
  "configurationJson": "{\"rules\":[]}"
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Enable the Data Catalog — r2.enableCatalog

Run Enable the Data Catalog with Cloudflare R2. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
bucketName string Required Bucket name minLength: 1; maxLength: 2000; pattern: "^[a-z0-9][a-z0-9-]{1,61}[a-z0-9]$"

Full JSON Schema

Full JSON Schema

Example input

{
  "bucketName": "example-bucket"
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Disable the Data Catalog — r2.disableCatalog

Run Disable the Data Catalog with Cloudflare R2. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
bucketName string Required Bucket name minLength: 1; maxLength: 2000; pattern: "^[a-z0-9][a-z0-9-]{1,61}[a-z0-9]$"

Full JSON Schema

Full JSON Schema

Example input

{
  "bucketName": "example-bucket"
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Disable Sippy migration — r2.disableSippy

Run Disable Sippy migration with Cloudflare R2. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
bucketName string Required Bucket name minLength: 1; maxLength: 2000; pattern: "^[a-z0-9][a-z0-9-]{1,61}[a-z0-9]$"

Full JSON Schema

Full JSON Schema

Example input

{
  "bucketName": "example-bucket"
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update the hosted domain — r2.updateManagedDomain

Run Update the hosted domain with Cloudflare R2. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
bucketName string Required Bucket name minLength: 1; maxLength: 2000; pattern: "^[a-z0-9][a-z0-9-]{1,61}[a-z0-9]$"
configurationJson string Required Managed-domain configuration (JSON object) minLength: 1; maxLength: 64000

Full JSON Schema

Full JSON Schema

Example input

{
  "bucketName": "example-bucket",
  "configurationJson": "{\"enabled\":true}"
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update Catalog maintenance settings — r2.updateCatalogMaintenanceConfig

Run Update Catalog maintenance settings with Cloudflare R2. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
bucketName string Required Bucket name minLength: 1; maxLength: 2000; pattern: "^[a-z0-9][a-z0-9-]{1,61}[a-z0-9]$"
configurationJson string Required Catalog maintenance configuration (JSON object) minLength: 1; maxLength: 64000

Full JSON Schema

Full JSON Schema

Example input

{
  "bucketName": "example-bucket",
  "configurationJson": "{\"compaction\":{\"state\":\"enabled\"}}"
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update table maintenance settings — r2.updateTableMaintenanceConfig

Run Update table maintenance settings with Cloudflare R2. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
bucketName string Required Bucket name minLength: 1; maxLength: 2000; pattern: "^[a-z0-9][a-z0-9-]{1,61}[a-z0-9]$"
namespace string Required Namespace minLength: 1; maxLength: 2000
tableName string Required Table name minLength: 1; maxLength: 2000
configurationJson string Required Table maintenance configuration (JSON object) minLength: 1; maxLength: 64000

Full JSON Schema

Full JSON Schema

Example input

{
  "bucketName": "example-bucket",
  "namespace": "default",
  "tableName": "events",
  "configurationJson": "{\"compaction\":{\"state\":\"enabled\"}}"
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Errors

Check the key's expiry, revocation, workspace and allowed operations.

Reuse the same idempotency key only for the same request.

The connection or provider limit has been reached. Check the receipt before retrying.

Test the connection

Open the integration's commands below to inspect parameters and examples. Start with a read command for an account or resource you can access. Refresh your client's tool list, use the returned tool name, and check the execution result and usage. Provider charges and permissions still apply. Never test a write against production data without reviewing it.

Official provider documentation

Type to search…

↑↓ navigate↵ selectEsc close