---
title: "Update Reminder"
method: POST
path: "/api/v1/reminders/{reminder_id}"
tags: ["Reminders"]
---

# Update Reminder

`POST /api/v1/reminders/{reminder_id}`

Update an existing reminder.

## Path parameters

- `reminder_id` string, required — String ID of the reminder

## Request body

- Body0d5e560b
  - `minute_offset` integer, nullable — Minutes before due time to trigger (for relative reminders).
  - `due` ReminderDueAttribute — Due date input for absolute reminders.
    - `date` string, nullable — Absolute reminder date in ISO 8601 format.
    - `string` string, nullable — Natural-language reminder date.
    - `lang` string, nullable — Language used to parse the natural-language date.
    - `timezone` string, nullable — Timezone for the reminder date.
    - `is_recurring` boolean, nullable — Whether the reminder date is recurring.
  - `service` union
    - 'email' | 'push'
    - 0 — Undefined object The object is used as a default argument in some constructors to differentiate from `None` which usually means in that context "reset the value". - Use the `parts.util.undefined` singleton for the default variable. - Use `is undefined` to see if value is undefined. - For type hints, use `YourType | Undefined` Usage example: ``` from parts.util import Undefined, undefined def update_item( id: int, title: str | Undefined = undefined, content: str | Undefined = undefined, ): pass ```
  - `is_urgent` boolean — Whether the reminder is an urgent reminder. Urgent reminders trigger an alarm notification on the user's designated urgent reminder device. Omit this field to keep it unchanged.

## Response `200`

Successful Response

- NotificationSyncView — A class with fields representing a NotificationView which will be returned to clients in a sync (or sync-like) response.
  - `id` string, required — String ID of the reminder.
  - `item_id` string, required — String ID of the task that owns the reminder.
  - `notify_uid` string, required — String ID of the user who receives the reminder.
  - `is_deleted` boolean, required — Whether the reminder is deleted.
  - `is_urgent` boolean, required — Whether the reminder should be delivered urgently.
  - `type` string, required — Reminder type.
  - `minute_offset` integer, nullable, required — Minutes before the task due time for relative reminders.
  - `due` object, nullable, required — Datetime when the reminder fires, or `null` if unset.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/todoist/apis/todoist-api.md) · [All operations](https://skmtc.net/todoist/apis/todoist-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/todoist/todoist-api/revisions/69a962f1578f/schema)