update_event

This reference is generated from the published tool contract.

Behavior and boundaries

Updates only the supplied fields of an event returned with canEdit=true, overwriting their previous values. It is limited to organizer-owned events and series without guests or conference data, so it cannot send meeting updates. To change time, supply start, end, and timeZone together. For an occurrence of a series, pass the occurrenceId from the same list_events or search_events result: only that occurrence changes (time, duration, title, description, location or availability) and all other occurrences stay unchanged. With editScope series, only title, description and location change for the whole series; its schedule never changes, and occurrences that were changed individually can keep their own values. Moving one occurrence of an all-day series is not supported.

Permissions

Granted scopes, accounts, calendars and visibility rules limit access. Workspace administrators do not automatically gain access to other users’ accounts.

calendar:read, calendar:write

Consent and boundaries

Input

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "calendarId": {
      "type": "string",
      "minLength": 1
    },
    "eventId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2048
    },
    "occurrenceId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "editScope": {
      "type": "string",
      "enum": [
        "occurrence",
        "series"
      ]
    },
    "title": {
      "type": "string",
      "minLength": 1,
      "maxLength": 512
    },
    "description": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 10000
        },
        {
          "type": "null"
        }
      ]
    },
    "location": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 1000
        },
        {
          "type": "null"
        }
      ]
    },
    "start": {
      "type": "string"
    },
    "end": {
      "type": "string"
    },
    "timeZone": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128
    },
    "freeBusyStatus": {
      "type": "string",
      "enum": [
        "free",
        "busy"
      ]
    }
  },
  "required": [
    "calendarId",
    "eventId"
  ],
  "additionalProperties": false
}

Output

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "const": true
    },
    "eventId": {
      "type": "string"
    }
  },
  "required": [
    "ok",
    "eventId"
  ],
  "additionalProperties": false
}

Errors and retries

Check the tool result for errors. Do not blindly retry writes after a timeout. Check the current resource or send status first.

Error handling