---
title: "Clear the account-wide default reminder"
method: DELETE
path: "/api/v1/reminder-settings/global-default"
tags: ["Reminders"]
---

# Clear the account-wide default reminder

`DELETE /api/v1/reminder-settings/global-default`

## Request

- Base URL: `https://volunteerreminder.com`
- URL: `https://volunteerreminder.com/api/v1/reminder-settings/global-default`
- Auth: HTTP bearer

Soft-delete the account-wide default reminder lead time. Returns the updated reminder configuration. 404 if no active default is set. Requires the `reminders:write` scope.

## Response `200`

The default was cleared; the updated configuration.

- ReminderSettingsResponse
  - `global_default` ReminderGlobalDefault, nullable, required: The first account-wide default lead time, or null if never configured. Prefer `global_defaults` when reading more than one reminder per shift.
    - `id` number, required: reminder_schedule_item id.
    - `days_before` integer, required: Whole days before the shift to send this reminder.
    - `hours_before` integer, required: Additional whole hours before the shift.
    - `minutes_before` integer, required: Additional whole minutes before the shift.
  - `global_defaults` ReminderGlobalDefault[], required: Every account-wide default lead time (longest first).
    - `id` number, required: reminder_schedule_item id.
    - `days_before` integer, required: Whole days before the shift to send this reminder.
    - `hours_before` integer, required: Additional whole hours before the shift.
    - `minutes_before` integer, required: Additional whole minutes before the shift.
  - `extra_sentence` string, nullable, required: Optional extra sentence appended to the fixed reminder wording, or null.
  - `reminder_cap` integer, required: How many reminders per shift this plan allows (1 / 2 / 3).
  - `job_overrides` ReminderJobOverride[], required: Per-job lead-time overrides. A job may have more than one row — one per lead. A live override set replaces the account defaults for that job.
    - `id` number, required: reminder_schedule_item id.
    - `job_id` number, required
    - `job_name` string, nullable, required
    - `days_before` integer, required: Whole days before the shift to send this reminder.
    - `hours_before` integer, required: Additional whole hours before the shift.
    - `minutes_before` integer, required: Additional whole minutes before the shift.
  - `channels` ReminderChannels, required
    - `email` object, required
      - `available` boolean, required: Email reminders are always available.
    - `sms` object, required
      - `available` boolean, required: Whether this account can actually send SMS/text reminders right now. This is the FULL gate the send loop applies (domain/smsGate via domain/reminderSelection): the plan must include SMS AND, for accounts created from 2026-08-10 on, a coordinator must have a verified mobile. See `reason` for which one is missing.
      - `reason` string, nullable, required: Why SMS is unavailable, or null when it is available.

## Other responses

- `401`: Missing or invalid API key.
- `403`: The API key lacks a scope required by this endpoint.
- `404`: The requested resource does not exist.

---

[API](https://skmtc.dev/volunteerreminder/apis/volunteerreminder-api.md) · [All operations](https://skmtc.dev/volunteerreminder/apis/volunteerreminder-api/llms.txt) · [OpenAPI document](https://skmtc.dev/volunteerreminder/apis/volunteerreminder-api/revisions/f8e7e26ba96f?raw)