update_reminder

Напоминания и Microsoft To Do · macOS

Эффект: запись. Статус: условно доступен.

«Условная доступность» означает, что инструмент может зависеть от версии, платформы, разрешений, учётной записи или настроек. Он доступен не во всех установках.

macOS

Назначение

Обновляет существующее напоминание в Reminders.app. Меняйте название, срок, заметки, приоритет, делайте его повторяющимся или отключайте повтор (recurrence) либо переносите в другой список (list_name). Получите reminder_id из list_reminders. Требует confirm=true. ВАЖНО: перенос в список в ДРУГОМ аккаунте (например, iCloud ↔ Exchange) пересоздаёт напоминание, поэтому его id меняется — тогда в ответе будет id_changed: true, новый id в reminder_id и прежний, уже недействительный, в previous_reminder_id. Перед любым последующим вызовом всегда берите reminder_id из ответа.

Обязательные входные данные

reminder_id

Имена сохранены в точности как их требует инструмент. Канонические технические определения на английском находятся в раскрываемой схеме ниже.

Разрешения и подтверждение

Схема объявляет явный параметр подтверждения. Проверьте предварительный результат и разрешите реальную операцию согласно контракту платформы.

Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях OAuth или разрешениях OS.

Каноническая техническая схема на английском — macOS

{
  "properties": {
    "confirm": {
      "description": "Must be true to apply changes",
      "type": "boolean"
    },
    "due_date": {
      "description": "New ISO 8601 due date. Pass empty string to clear (optional)",
      "type": "string"
    },
    "list_name": {
      "description": "Move the reminder to this list (a name from get_reminder_folders) (optional). Moving to a list in ANOTHER account recreates the reminder and CHANGES its id — read the new one from reminder_id in the response (id_changed: true).",
      "type": "string"
    },
    "notes": {
      "description": "New notes text (optional)",
      "type": "string"
    },
    "priority": {
      "description": "Priority: none | low | medium | high (optional)",
      "enum": [
        "none",
        "low",
        "medium",
        "high"
      ],
      "type": "string"
    },
    "recurrence": {
      "description": "Make it a repeating reminder: 'daily', 'weekly', 'monthly', or 'yearly' ('none' stops an existing repetition; omit to leave it as it is). A repeating reminder needs a due date.",
      "enum": [
        "daily",
        "weekly",
        "monthly",
        "yearly",
        "none"
      ],
      "type": "string"
    },
    "recurrence_count": {
      "description": "Total number of occurrences (optional). Mutually exclusive with recurrence_until; if neither is given it repeats indefinitely. Needs recurrence.",
      "type": "integer"
    },
    "recurrence_interval": {
      "description": "Repeat every N periods (optional, default 1 — e.g. recurrence='weekly' + recurrence_interval=2 = every 2 weeks). Needs recurrence.",
      "type": "integer"
    },
    "recurrence_until": {
      "description": "ISO 8601 date the repetition stops on (optional; takes precedence over recurrence_count). Needs recurrence.",
      "type": "string"
    },
    "reminder_id": {
      "description": "Reminder identifier from list_reminders",
      "type": "string"
    },
    "title": {
      "description": "New title (optional)",
      "type": "string"
    }
  },
  "required": [
    "reminder_id"
  ],
  "type": "object"
}

Пример для документации

Пример документации для update_reminder. Не выполняйте этот пример. Показанные аргументы относятся к вымышленному набору данных; перед реальным вызовом найдите настоящие идентификаторы и получите разрешение.

{
  "confirm": false,
  "reminder_id": "demo-reminder-001",
  "title": "Review the launch checklist"
}