## Update catalog maintenance configuration

**post** `/accounts/{account_id}/r2-catalog/{bucket_name}/maintenance-configs`

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

### Path Parameters

- `account_id: string`

  Use this to identify the account.

- `bucket_name: string`

  Specifies the R2 bucket name.

### Body Parameters

- `compaction: optional object { state, target_size_mb }`

  Updates compaction configuration (all fields optional).

  - `state: optional "enabled" or "disabled"`

    Updates the state optionally.

    - `"enabled"`

    - `"disabled"`

  - `target_size_mb: optional "64" or "128" or "256" or "512"`

    Updates the target file size optionally.

    - `"64"`

    - `"128"`

    - `"256"`

    - `"512"`

- `snapshot_expiration: optional object { max_snapshot_age, min_snapshots_to_keep, state }`

  Updates snapshot expiration configuration (all fields optional).

  - `max_snapshot_age: optional string`

    Updates the maximum age for snapshots optionally.

  - `min_snapshots_to_keep: optional number`

    Updates the minimum number of snapshots to retain optionally.

  - `state: optional "enabled" or "disabled"`

    Updates the state optionally.

    - `"enabled"`

    - `"disabled"`

### Returns

- `errors: array of object { code, message }`

  Contains errors if the API call was unsuccessful.

  - `code: number`

    Specifies the error code.

  - `message: string`

    Describes the error.

- `messages: array of object { code, message }`

  Contains informational messages.

  - `code: number`

    Specifies the message code.

  - `message: string`

    Contains the message text.

- `success: boolean`

  Indicates whether the API call was successful.

- `result: optional object { compaction, snapshot_expiration }`

  Configures maintenance for the catalog.

  - `compaction: optional object { state, target_size_mb }`

    Configures compaction for catalog maintenance.

    - `state: "enabled" or "disabled"`

      Specifies the state of maintenance operations.

      - `"enabled"`

      - `"disabled"`

    - `target_size_mb: "64" or "128" or "256" or "512"`

      Sets the target file size for compaction in megabytes. Defaults to "128".

      - `"64"`

      - `"128"`

      - `"256"`

      - `"512"`

  - `snapshot_expiration: optional object { max_snapshot_age, min_snapshots_to_keep, state }`

    Configures snapshot expiration settings.

    - `max_snapshot_age: string`

      Specifies the maximum age for snapshots. The system deletes snapshots older than this age.
      Format: <number><unit> where unit is d (days), h (hours), m (minutes), or s (seconds).
      Examples: "7d" (7 days), "48h" (48 hours), "2880m" (2,880 minutes).
      Defaults to "7d".

    - `min_snapshots_to_keep: number`

      Specifies the minimum number of snapshots to retain. Defaults to 100.

    - `state: "enabled" or "disabled"`

      Specifies the state of maintenance operations.

      - `"enabled"`

      - `"disabled"`

### Example

```http
curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/r2-catalog/$BUCKET_NAME/maintenance-configs \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
    -d '{}'
```

#### Response

```json
{
  "errors": [],
  "messages": [],
  "result": {
    "compaction": {
      "state": "enabled",
      "target_size_mb": "256"
    },
    "snapshot_expiration": {
      "max_snapshot_age": "14d",
      "min_snapshots_to_keep": 5,
      "state": "enabled"
    }
  },
  "success": true
}
```