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. V1 is intentionally limited to organizer-owned standalone events without guests or conference data, so it cannot send meeting updates. To change time, supply start, end, and timeZone together.

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
    },
    "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 calendar state first.

Error handling