latestOpenAPI 3.1.02026-08-211061591.1 MB

69a962f1578f

Reminders

Update Reminder

Update an existing reminder.

post/api/v1/reminders/{reminder_id}

Path parameters

reminder_idstring required

String ID of the reminder

Example:6XGgmFQrx44wfGHr

Request body

minute_offsetinteger nullable

Minutes before due time to trigger (for relative reminders).

is_urgentboolean

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.

Example request

{
  "minute_offset": 30,
  "due": {
    "date": "2025-02-12T09:00:00",
    "string": "tomorrow at 9am",
    "lang": "en",
    "timezone": "Europe/Madrid"
  }
}

Response

Successful Response

idstring required

String ID of the reminder.

item_idstring required

String ID of the task that owns the reminder.

notify_uidstring required

String ID of the user who receives the reminder.

is_deletedboolean required

Whether the reminder is deleted.

is_urgentboolean required

Whether the reminder should be delivered urgently.

typestring required

Reminder type.

minute_offsetinteger nullable required

Minutes before the task due time for relative reminders.

dueobject nullable required

Datetime when the reminder fires, or null if unset.

Example response

{
  "id": "6XGgmFQrx44wfGHr",
  "item_id": "6XGgmFVcrG5RRjVr",
  "notify_uid": "1234567",
  "type": "relative",
  "minute_offset": 30,
  "due": {
    "date": "2025-02-12T09:00:00",
    "lang": "en",
    "timezone": "Europe/Madrid"
  }
}