POST /accounts/{account_id}/r2-catalog/{bucket_name}/namespaces/{namespace}/tables/{table_name}/maintenance-configs

Update the maintenance configuration for a specific table. This allows you to enable or disable compaction and adjust target file sizes for optimization.

Servers

Path parameters

Name Type Required Description
table_name String Yes

The table name.

bucket_name String Yes

Specifies the R2 bucket name.

namespace String Yes

The namespace identifier (use %1F as separator for nested namespaces).

account_id String Yes

Identifies the account.

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Request body fields

Name Type Required Description
compaction Object No

Updates compaction configuration (all fields optional).

compaction.target_size_mb String No

Updates the target file size optionally.

Valid values:

  • "64"
  • "256"
  • "512"
  • "128"

Default value: "128"

compaction.state String No

Updates the state optionally.

Valid values:

  • "disabled"
  • "enabled"

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.