Zum Inhalt springen
Alle Werkzeuge

update_reminder

Erinnerungen und Microsoft To Do · macOS

Wirkung: Schreiben. Status: bedingt verfügbar.

„Bedingte Verfügbarkeit“ bedeutet, dass das Werkzeug von Version, Plattform, Berechtigungen, Konto oder Konfiguration abhängen kann. Es ist nicht in jeder Installation aktiv.

macOS

Zweck

Aktualisiert eine bestehende Erinnerung in Reminders.app. Ändern Sie Titel, Fälligkeitsdatum, Notizen, Priorität, lassen Sie sie sich wiederholen oder nicht mehr wiederholen (recurrence) oder verschieben Sie sie in eine andere Liste (list_name). Holen Sie reminder_id aus list_reminders. Erfordert confirm=true. WICHTIG: Das Verschieben in eine Liste eines ANDEREN Kontos (z. B. iCloud ↔ Exchange) erstellt die Erinnerung neu, ihre ID ändert sich also – die Antwort enthält dann id_changed: true, die neue ID in reminder_id und die ungültige in previous_reminder_id. Entnehmen Sie reminder_id vor jedem Folgeaufruf immer der Antwort.

Erforderliche Eingaben

Die Namen bleiben exakt so erhalten, wie das Werkzeug sie verlangt. Die kanonischen technischen Definitionen auf Englisch stehen im ausklappbaren Schema unten.

Berechtigungen und Bestätigung

Das Schema deklariert einen ausdrücklichen Bestätigungsparameter. Prüfen Sie die Vorschau und autorisieren Sie den echten Vorgang gemäß Plattformvertrag.

Kanonisches technisches Schema auf Englisch — 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"
}

Dokumentationsbeispiel

Dokumentationsbeispiel für update_reminder. Führen Sie dieses Beispiel nicht aus. Die gezeigten Argumente gehören zu einem fiktiven Datensatz; ermitteln Sie reale Kennungen und holen Sie vor einem echten Aufruf die Genehmigung ein.

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