---
title: "Update Block Data Settings"
method: PATCH
path: "/api/v1/admin/system-settings/block-data-settings"
tags: ["Admin APIs", "system-settings"]
---

# Update Block Data Settings

`PATCH /api/v1/admin/system-settings/block-data-settings`

## Request body

- BlockDataSettingsUpdate — Payload to update Block Data settings. Omitted fields are left untouched. ``rationale`` is always required.
  - `notifications_enabled` boolean, nullable
  - `trial_end_recipient_email` string, nullable
  - `trial_ending_notice_days` integer, nullable
  - `contract_ending_notice_days` integer, nullable
  - `contract_grace_days` integer, nullable
  - `invoice_edit_window_days` integer, nullable
  - `payment_alerts_enabled` boolean, nullable
  - `overdue_alert_after_days` integer, nullable
  - `overdue_alert_repeat_days` integer, nullable
  - `access_failure_p3_sla_minutes` integer, nullable
  - `access_failure_drain_enabled` boolean, nullable
  - `access_failure_drain_batch_limit` integer, nullable
  - `rationale` string, required — Required. Why this change is being made (min 3 characters, trimmed).

## Response `200`

Successful Response

- BlockDataSettingsRead — Block Data feature-level settings surfaced on the System Settings page.
  - `notifications_enabled` SettingFieldBool, required
    - `value` boolean, required
    - `updated_at` string, date-time, nullable
    - `updated_by` string, nullable
    - `last_rationale` string, nullable
  - `trial_end_recipient_email` SettingFieldStr, required
    - `value` string, required
    - `updated_at` string, date-time, nullable
    - `updated_by` string, nullable
    - `last_rationale` string, nullable
  - `trial_ending_notice_days` SettingFieldInt, required
    - `value` integer, required
    - `updated_at` string, date-time, nullable
    - `updated_by` string, nullable
    - `last_rationale` string, nullable
  - `contract_ending_notice_days` SettingFieldInt, required
    - `value` integer, required
    - `updated_at` string, date-time, nullable
    - `updated_by` string, nullable
    - `last_rationale` string, nullable
  - `contract_grace_days` SettingFieldInt, required
    - `value` integer, required
    - `updated_at` string, date-time, nullable
    - `updated_by` string, nullable
    - `last_rationale` string, nullable
  - `invoice_edit_window_days` SettingFieldInt, required
    - `value` integer, required
    - `updated_at` string, date-time, nullable
    - `updated_by` string, nullable
    - `last_rationale` string, nullable
  - `payment_alerts_enabled` SettingFieldBool, required
    - `value` boolean, required
    - `updated_at` string, date-time, nullable
    - `updated_by` string, nullable
    - `last_rationale` string, nullable
  - `overdue_alert_after_days` SettingFieldInt, required
    - `value` integer, required
    - `updated_at` string, date-time, nullable
    - `updated_by` string, nullable
    - `last_rationale` string, nullable
  - `overdue_alert_repeat_days` SettingFieldInt, required
    - `value` integer, required
    - `updated_at` string, date-time, nullable
    - `updated_by` string, nullable
    - `last_rationale` string, nullable
  - `access_failure_p3_sla_minutes` SettingFieldInt, required
    - `value` integer, required
    - `updated_at` string, date-time, nullable
    - `updated_by` string, nullable
    - `last_rationale` string, nullable
  - `access_failure_drain_enabled` SettingFieldBool, required
    - `value` boolean, required
    - `updated_at` string, date-time, nullable
    - `updated_by` string, nullable
    - `last_rationale` string, nullable
  - `access_failure_drain_batch_limit` SettingFieldInt, required
    - `value` integer, required
    - `updated_at` string, date-time, nullable
    - `updated_by` string, nullable
    - `last_rationale` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/carbonarc/apis/carbon-arc-client-admin-api.md) · [All operations](https://skmtc.net/carbonarc/apis/carbon-arc-client-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carbonarc/carbon-arc-client-admin-api/revisions/a8ca30023371/schema)