---
title: "Remove a per-job reminder override"
method: DELETE
path: "/api/v1/reminder-settings/job-overrides/{id}"
tags: ["Reminders"]
---

# Remove a per-job reminder override

`DELETE /api/v1/reminder-settings/job-overrides/{id}`

## Request

- Base URL: `https://volunteerreminder.com`
- URL: `https://volunteerreminder.com/api/v1/reminder-settings/job-overrides/{id}`
- Auth: HTTP bearer

Soft-delete the reminder lead-time override for one job (addressed by JOB id). Returns the updated reminder configuration. 404 if the job has no active override on this account. Requires the `reminders:write` scope.

## Path parameters

- `id` string, required: The JOB id whose lead-time override should be removed.

## Response `200`

The override was removed; 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

- `400`: The request failed schema validation (`validation_error`). On the import endpoints, also when the text is UTF-16 (Excel "Unicode Text"; `unsupported_encoding`): resend it as CSV UTF-8.
- `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)