Ir para o conteúdo
Todas as ferramentas

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

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.

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