update_reminder

macOS

Scopo

Aggiorna un promemoria esistente in Reminders.app. Può cambiare titolo, scadenza, note o priorità, oppure spostarlo in un altro elenco tramite list_name. Ottenere reminder_id da list_reminders. Richiede confirm=true. IMPORTANTE: lo spostamento in un elenco di un account DIVERSO, per esempio iCloud ↔ Exchange, ricrea il promemoria e ne cambia l’id. In quel caso la risposta contiene id_changed: true, il nuovo id in reminder_id e quello non più valido in previous_reminder_id. Prima di qualsiasi chiamata successiva usare sempre reminder_id restituito dalla risposta.

Input obbligatori

• reminder_id

I nomi restano esattamente quelli richiesti dallo strumento. Le definizioni tecniche canoniche in inglese sono nello schema espandibile qui sotto.

Autorizzazioni e conferma

Lo schema dichiara un parametro di conferma esplicito. Controlla l’anteprima e autorizza l’operazione reale secondo il contratto della piattaforma.

• Utilizza solo le app, gli account e le risorse autorizzate dall'utente su questa piattaforma. Consulta la descrizione specifica della piattaforma di questo strumento per i suoi requisiti di connessione e autorizzazione; questo catalogo non afferma ambiti OAuth aggiuntivi o diritti del sistema operativo.

{
  "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"
    },
    "reminder_id": {
      "description": "Reminder identifier from list_reminders",
      "type": "string"
    },
    "title": {
      "description": "New title (optional)",
      "type": "string"
    }
  },
  "required": [
    "reminder_id"
  ],
  "type": "object"
}

Esempio documentale

Esempio di documentazione per update_reminder. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.

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