update_calendar_event
Calendário · macOS
Efeito: escrita. Estado: disponibilidade condicionada.
«Disponibilidade condicionada» significa que a ferramenta pode depender da versão, plataforma, permissões, conta ou configuração. Não significa que esteja ativa em todas as instalações.
macOS
Finalidade
Atualiza um evento existente no app Calendário do Mac (Calendar.app) por ID. Passe apenas os campos que deseja alterar; os campos não especificados permanecem como estão. Obtenha o event_id em list_calendar_events; para um evento recorrente, passe o id por ocorrência da linha específica a que você se refere, não um id de série puro. Para o Microsoft 365, use m365_list_events / m365_create_event em vez disso (listadas quando uma conta do Microsoft 365 está conectada).
Entradas obrigatórias
event_id
Os nomes são mantidos exatamente como a ferramenta exige. As definições técnicas canónicas em inglês estão no esquema expansível abaixo.
Permissões e confirmação
O esquema declara um parâmetro explícito de confirmação. Reveja a pré-visualização e autorize a operação real de acordo com o contrato da plataforma.
- Utilize apenas os aplicativos, contas e recursos autorizados pelo usuário nesta plataforma. Consulte a descrição específica da plataforma desta ferramenta para saber os requisitos de conexão e permissão; este catálogo não reivindica escopos OAuth adicionais ou direitos de sistema operacional.
Esquema técnico canónico em inglês — 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"
}Exemplo documental
Exemplo de documentação para update_calendar_event. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.
{
"confirm": false,
"event_id": "demo-event-001",
"title": "Launch planning meeting"
}