Vai al contenuto
Tutti gli strumenti

update_calendar_event

Calendario · macOS

Effetto: scrittura. Stato: disponibilità condizionata.

«Disponibilità condizionata» indica che lo strumento può dipendere da versione, piattaforma, autorizzazioni, account o configurazione. Non è necessariamente attivo ovunque.

macOS

Scopo

Aggiorna un evento esistente nell'app Calendario del Mac (Calendar.app) tramite ID. Passa solo i campi che vuoi cambiare: i campi non specificati restano invariati. Ottieni l'event_id da list_calendar_events; per un evento ricorrente, passa l'id della singola occorrenza dalla riga specifica a cui ti riferisci, non un semplice id di serie. Per Microsoft 365 usa invece m365_list_events / m365_create_event (elencati una volta collegato un account Microsoft 365).

Input obbligatori

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.

Schema tecnico canonico in inglese — macOS
{
  "properties": {
    "confirm": {
      "description": "Must be true to apply changes",
      "type": "boolean"
    },
    "end_date": {
      "description": "New end datetime ISO 8601 (optional). Same timezone rules as start_date.",
      "type": "string"
    },
    "event_id": {
      "description": "Event (or occurrence) identifier from list_calendar_events. For a recurring event this addresses exactly the occurrence that id came from — the preview names the date and scope so you can confirm before applying.",
      "type": "string"
    },
    "location": {
      "description": "New location — pass empty string to clear (optional)",
      "type": "string"
    },
    "notes": {
      "description": "New notes — pass empty string to clear (optional)",
      "type": "string"
    },
    "span": {
      "description": "For recurring events: 'this' (default — only this occurrence) or 'future' (this and all following occurrences; 'all'/'series' mean the same). Any other value is refused.",
      "type": "string"
    },
    "start_date": {
      "description": "New start datetime ISO 8601 (optional). No timezone = Mac's local time; append Z/offset to pin the zone.",
      "type": "string"
    },
    "title": {
      "description": "New title (optional)",
      "type": "string"
    }
  },
  "required": [
    "event_id"
  ],
  "type": "object"
}

Esempio documentale

Esempio di documentazione per update_calendar_event. 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,
  "event_id": "demo-event-001",
  "title": "Launch planning meeting"
}