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
event_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.
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"
}