Skip to main content
Glama

calendar.events.patch

Update selected fields of a Google Calendar event with PATCH semantics, optionally notifying guests based on the configured sendUpdates setting.

Instructions

Updates an event. This method supports patch semantics [HTTP PATCH] — updates the resource; refused under --readonly safety profiles. Returns the API's response resource as JSON — request body is a JSON Event object accepting anyoneCanAddSelf, attachments, attendees, attendeesOmitted, birthdayProperties, colorId, conferenceData, created and 36 more fields; pass it via params or whole via body_file Siblings over the same resource: delete, get, import, insert, instances, list, move, quickAdd, update, watch.

Input Schema

NameRequiredDescriptionDefault
queryNoExtra KEY=VALUE query pairs for endpoints whose parameters Discovery does not describe.
paramsNoParameter map merged into the request; typed parameters win.
dry_runNoReturn the request that would be sent, without sending it.
eventIdYes[URL path segment] Event identifier.
body_fileNoRead the request body from this file ('-' for stdin) instead of building one from the parameters. The body is a JSON Event object.
calendarIdYes[URL path segment] Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use
sendUpdatesNo[query parameter] Guests who should receive notifications about the event update (for example, title changes, etc.). Values: `all` = Notifications are sent to all guests.; `externalOnly` = Notifications are sent to non-Google Calendar guests only.; `none` = No notifications are sent. For calendar migration tasks, consider using the Events.import method instead..
maxAttendeesNo[query parameter] The maximum number of attendees to include in the response. If there are more than the specified number of attendees, only the participant is returned. Optional
request_bodyNoRequest body of type Event: pass it via `params` (merged into the built body) or whole via `body_file`.
eventLabelVersionNo[query parameter] Version number of the event label feature supported by the API client. Version 0 assumes no event label support and processes the colorId field for color manage
sendNotificationsNo[query parameter] Deprecated. Please use sendUpdates instead. Whether to send notifications about the event update (for example, description changes, etc.). Note that some emails
alwaysIncludeEmailNo[query parameter] Deprecated and ignored. A value will always be returned in the email field for the organizer, creator and attendees, even if no real email address is available
supportsAttachmentsNo[query parameter] Whether API client performing operation supports event attachments. Optional. The default is False.
conferenceDataVersionNo[query parameter] Version number of conference data supported by the API client. Version 0 assumes no conference data support and ignores conference data in the event's body. Ver

Output Schema

NameRequiredDescriptionDefault
idNo
endNo
etagNo
kindNo
startNo
gadgetNo
lockedNo
sourceNo
statusNo
colorIdNo
createdNo
creatorNo
iCalUIDNo
summaryNo
updatedNo
htmlLinkNo
locationNo
sequenceNo
attendeesNo
eventTypeNo
organizerNo
remindersNo
recurrenceNo
visibilityNo
attachmentsNo
descriptionNo
hangoutLinkNo
privateCopyNo
eventLabelIdNo
transparencyNo
conferenceDataNo
guestsCanModifyNo
anyoneCanAddSelfNo
attendeesOmittedNo
recurringEventIdNo
originalStartTimeNo
birthdayPropertiesNo
endTimeUnspecifiedNo
extendedPropertiesNo
focusTimePropertiesNo
guestsCanInviteOthersNo
outOfOfficePropertiesNo
guestsCanSeeOtherGuestsNo
workingLocationPropertiesNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • changedInput schema / properties / body_file / description
      Previous value: -"Read the request body from this file ('-' for stdin) instead of building one from the parameters."New value: +"Read the request body from this file ('-' for stdin) instead of building one from the parameters. The body is a JSON Event object."
    • addedInput schema / properties / request_body
      Added value: +{
      +  "description": "Request body of type Event: pass it via `params` (merged into the built body) or whole via `body_file`.",
      +  "properties": {
      +    "anyoneCanAddSelf": {
      +      "type": "boolean"
      +    },
      +    "attachments": {
      +      "items": {
      +        "properties": {
      +          "fileId": {
      +            "type": "string"
      +          },
      +          "fileUrl": {
      +            "type": "string"
      +          },
      +          "iconLink": {
      +            "type": "string"
      +          },
      +          "mimeType": {
      +            "type": "string"
      +          },
      +          "title": {
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "attendees": {
      +      "items": {
      +        "properties": {
      +          "additionalGuests": {
      +            "type": "integer"
      +          },
      +          "asyncOperation": {
      +            "type": "string"
      +          },
      +          "comment": {
      +            "type": "string"
      +          },
      +          "displayName": {
      +            "type": "string"
      +          },
      +          "email": {
      +            "type": "string"
      +          },
      +          "id": {
      +            "type": "string"
      +          },
      +          "optional": {
      +            "type": "boolean"
      +          },
      +          "organizer": {
      +            "type": "boolean"
      +          },
      +          "resource": {
      +            "type": "boolean"
      +          },
      +          "responseStatus": {
      +            "type": "string"
      +          },
      +          "self": {
      +            "type": "boolean"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "attendeesOmitted": {
      +      "type": "boolean"
      +    },
      +    "birthdayProperties": {
      +      "properties": {
      +        "contact": {
      +          "type": "string"
      +        },
      +        "customTypeName": {
      +          "type": "string"
      +        },
      +        "type": {
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "colorId": {
      +      "type": "string"
      +    },
      +    "conferenceData": {
      +      "properties": {
      +        "conferenceId": {
      +          "type": "string"
      +        },
      +        "conferenceSolution": {
      +          "properties": {
      +            "iconUri": {
      +              "type": "string"
      +            },
      +            "key": {
      +              "properties": {
      +                "type": {
      +                  "type": "string"
      +                }
      +              },
      +              "type": "object"
      +            },
      +            "name": {
      +              "type": "string"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "createRequest": {
      +          "properties": {
      +            "conferenceSolutionKey": {
      +              "properties": {
      +                "type": {
      +                  "type": "string"
      +                }
      +              },
      +              "type": "object"
      +            },
      +            "requestId": {
      +              "type": "string"
      +            },
      +            "status": {
      +              "properties": {
      +                "statusCode": {
      +                  "type": "string"
      +                }
      +              },
      +              "type": "object"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "entryPoints": {
      +          "items": {
      +            "properties": {
      +              "accessCode": {
      +                "type": "string"
      +              },
      +              "entryPointFeatures": {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "entryPointType": {
      +                "type": "string"
      +              },
      +              "label": {
      +                "type": "string"
      +              },
      +              "meetingCode": {
      +                "type": "string"
      +              },
      +              "passcode": {
      +                "type": "string"
      +              },
      +              "password": {
      +                "type": "string"
      +              },
      +              "pin": {
      +                "type": "string"
      +              },
      +              "regionCode": {
      +                "type": "string"
      +              },
      +              "uri": {
      +                "type": "string"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "notes": {
      +          "type": "string"
      +        },
      +        "parameters": {
      +          "properties": {
      +            "addOnParameters": {
      +              "properties": {
      +                "parameters": {
      +                  "type": "object"
      +                }
      +              },
      +              "type": "object"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "signature": {
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "created": {
      +      "type": "string"
      +    },
      +    "creator": {
      +      "properties": {
      +        "displayName": {
      +          "type": "string"
      +        },
      +        "email": {
      +          "type": "string"
      +        },
      +        "id": {
      +          "type": "string"
      +        },
      +        "self": {
      +          "type": "boolean"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "description": {
      +      "type": "string"
      +    },
      +    "end": {
      +      "properties": {
      +        "date": {
      +          "type": "string"
      +        },
      +        "dateTime": {
      +          "type": "string"
      +        },
      +        "timeZone": {
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "endTimeUnspecified": {
      +      "type": "boolean"
      +    },
      +    "etag": {
      +      "type": "string"
      +    },
      +    "eventLabelId": {
      +      "type": "string"
      +    },
      +    "eventType": {
      +      "type": "string"
      +    },
      +    "extendedProperties": {
      +      "properties": {
      +        "private": {
      +          "type": "object"
      +        },
      +        "shared": {
      +          "type": "object"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "focusTimeProperties": {
      +      "properties": {
      +        "autoDeclineMode": {
      +          "type": "string"
      +        },
      +        "chatStatus": {
      +          "type": "string"
      +        },
      +        "declineMessage": {
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "gadget": {
      +      "properties": {
      +        "display": {
      +          "type": "string"
      +        },
      +        "height": {
      +          "type": "integer"
      +        },
      +        "iconLink": {
      +          "type": "string"
      +        },
      +        "link": {
      +          "type": "string"
      +        },
      +        "preferences": {
      +          "type": "object"
      +        },
      +        "title": {
      +          "type": "string"
      +        },
      +        "type": {
      +          "type": "string"
      +        },
      +        "width": {
      +          "type": "integer"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "guestsCanInviteOthers": {
      +      "type": "boolean"
      +    },
      +    "guestsCanModify": {
      +      "type": "boolean"
      +    },
      +    "guestsCanSeeOtherGuests": {
      +      "type": "boolean"
      +    },
      +    "hangoutLink": {
      +      "type": "string"
      +    },
      +    "htmlLink": {
      +      "type": "string"
      +    },
      +    "iCalUID": {
      +      "type": "string"
      +    },
      +    "id": {
      +      "type": "string"
      +    },
      +    "kind": {
      +      "type": "string"
      +    },
      +    "location": {
      +      "type": "string"
      +    },
      +    "locked": {
      +      "type": "boolean"
      +    },
      +    "organizer": {
      +      "properties": {
      +        "displayName": {
      +          "type": "string"
      +        },
      +        "email": {
      +          "type": "string"
      +        },
      +        "id": {
      +          "type": "string"
      +        },
      +        "self": {
      +          "type": "boolean"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "originalStartTime": {
      +      "properties": {
      +        "date": {
      +          "type": "string"
      +        },
      +        "dateTime": {
      +          "type": "string"
      +        },
      +        "timeZone": {
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "outOfOfficeProperties": {
      +      "properties": {
      +        "autoDeclineMode": {
      +          "type": "string"
      +        },
      +        "declineMessage": {
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "privateCopy": {
      +      "type": "boolean"
      +    },
      +    "recurrence": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "recurringEventId": {
      +      "type": "string"
      +    },
      +    "reminders": {
      +      "properties": {
      +        "overrides": {
      +          "items": {
      +            "properties": {
      +              "method": {
      +                "type": "string"
      +              },
      +              "minutes": {
      +                "type": "integer"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "useDefault": {
      +          "type": "boolean"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "sequence": {
      +      "type": "integer"
      +    },
      +    "source": {
      +      "properties": {
      +        "title": {
      +          "type": "string"
      +        },
      +        "url": {
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "start": {
      +      "properties": {
      +        "date": {
      +          "type": "string"
      +        },
      +        "dateTime": {
      +          "type": "string"
      +        },
      +        "timeZone": {
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "status": {
      +      "type": "string"
      +    },
      +    "summary": {
      +      "type": "string"
      +    },
      +    "transparency": {
      +      "type": "string"
      +    },
      +    "updated": {
      +      "type": "string"
      +    },
      +    "visibility": {
      +      "type": "string"
      +    },
      +    "workingLocationProperties": {
      +      "properties": {
      +        "customLocation": {
      +          "properties": {
      +            "label": {
      +              "type": "string"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "homeOffice": {
      +          "type": "any"
      +        },
      +        "officeLocation": {
      +          "properties": {
      +            "buildingId": {
      +              "type": "string"
      +            },
      +            "deskId": {
      +              "type": "string"
      +            },
      +            "floorId": {
      +              "type": "string"
      +            },
      +            "floorSectionId": {
      +              "type": "string"
      +            },
      +            "label": {
      +              "type": "string"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "type": {
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    }
      +  },
      +  "type": "object"
      +}
  2. Changed18 schema fields changed
    • changedInput schema / properties / alwaysIncludeEmail / description
      Previous value: -"Deprecated and ignored. A value will always be returned in the email field for the organizer, creator and attendees, even if no real email address is available "New value: +"[query parameter] Deprecated and ignored. A value will always be returned in the email field for the organizer, creator and attendees, even if no real email address is available "
    • changedInput schema / properties / calendarId / description
      Previous value: -"Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use"New value: +"[URL path segment] Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use"
    • changedInput schema / properties / conferenceDataVersion / description
      Previous value: -"Version number of conference data supported by the API client. Version 0 assumes no conference data support and ignores conference data in the event's body. Ver"New value: +"[query parameter] Version number of conference data supported by the API client. Version 0 assumes no conference data support and ignores conference data in the event's body. Ver"
    • addedInput schema / properties / conferenceDataVersion / format
      Added value: +"int32"
    • addedInput schema / properties / conferenceDataVersion / maximum
      Added value: +1
    • addedInput schema / properties / conferenceDataVersion / minimum
      Added value: +0
    • changedInput schema / properties / eventId / description
      Previous value: -"Event identifier."New value: +"[URL path segment] Event identifier."
    • changedInput schema / properties / eventLabelVersion / description
      Previous value: -"Version number of the event label feature supported by the API client. Version 0 assumes no event label support and processes the colorId field for color manage"New value: +"[query parameter] Version number of the event label feature supported by the API client. Version 0 assumes no event label support and processes the colorId field for color manage"
    • addedInput schema / properties / eventLabelVersion / format
      Added value: +"int32"
    • addedInput schema / properties / eventLabelVersion / maximum
      Added value: +1
    • addedInput schema / properties / eventLabelVersion / minimum
      Added value: +0
    • changedInput schema / properties / maxAttendees / description
      Previous value: -"The maximum number of attendees to include in the response. If there are more than the specified number of attendees, only the participant is returned. Optional"New value: +"[query parameter] The maximum number of attendees to include in the response. If there are more than the specified number of attendees, only the participant is returned. Optional"
    • addedInput schema / properties / maxAttendees / format
      Added value: +"int32"
    • addedInput schema / properties / maxAttendees / minimum
      Added value: +1
    • changedInput schema / properties / sendNotifications / description
      Previous value: -"Deprecated. Please use sendUpdates instead. Whether to send notifications about the event update (for example, description changes, etc.). Note that some emails"New value: +"[query parameter] Deprecated. Please use sendUpdates instead. Whether to send notifications about the event update (for example, description changes, etc.). Note that some emails"
    • changedInput schema / properties / sendUpdates / description
      Previous value: -"Guests who should receive notifications about the event update (for example, title changes, etc.)."New value: +"[query parameter] Guests who should receive notifications about the event update (for example, title changes, etc.). Values: `all` = Notifications are sent to all guests.; `externalOnly` = Notifications are sent to non-Google Calendar guests only.; `none` = No notifications are sent. For calendar migration tasks, consider using the Events.import method instead.."
    • changedInput schema / properties / supportsAttachments / description
      Previous value: -"Whether API client performing operation supports event attachments. Optional. The default is False."New value: +"[query parameter] Whether API client performing operation supports event attachments. Optional. The default is False."
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "properties": {
      +    "anyoneCanAddSelf": {
      +      "type": "boolean"
      +    },
      +    "attachments": {
      +      "items": {
      +        "properties": {
      +          "fileId": {
      +            "type": "string"
      +          },
      +          "fileUrl": {
      +            "type": "string"
      +          },
      +          "iconLink": {
      +            "type": "string"
      +          },
      +          "mimeType": {
      +            "type": "string"
      +          },
      +          "title": {
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "attendees": {
      +      "items": {
      +        "properties": {
      +          "additionalGuests": {
      +            "type": "integer"
      +          },
      +          "asyncOperation": {
      +            "type": "string"
      +          },
      +          "comment": {
      +            "type": "string"
      +          },
      +          "displayName": {
      +            "type": "string"
      +          },
      +          "email": {
      +            "type": "string"
      +          },
      +          "id": {
      +            "type": "string"
      +          },
      +          "optional": {
      +            "type": "boolean"
      +          },
      +          "organizer": {
      +            "type": "boolean"
      +          },
      +          "resource": {
      +            "type": "boolean"
      +          },
      +          "responseStatus": {
      +            "type": "string"
      +          },
      +          "self": {
      +            "type": "boolean"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "attendeesOmitted": {
      +      "type": "boolean"
      +    },
      +    "birthdayProperties": {
      +      "properties": {
      +        "contact": {
      +          "type": "string"
      +        },
      +        "customTypeName": {
      +          "type": "string"
      +        },
      +        "type": {
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "colorId": {
      +      "type": "string"
      +    },
      +    "conferenceData": {
      +      "properties": {
      +        "conferenceId": {
      +          "type": "string"
      +        },
      +        "conferenceSolution": {
      +          "properties": {
      +            "iconUri": {
      +              "type": "string"
      +            },
      +            "key": {
      +              "properties": {
      +                "type": {
      +                  "type": "string"
      +                }
      +              },
      +              "type": "object"
      +            },
      +            "name": {
      +              "type": "string"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "createRequest": {
      +          "properties": {
      +            "conferenceSolutionKey": {
      +              "properties": {
      +                "type": {
      +                  "type": "string"
      +                }
      +              },
      +              "type": "object"
      +            },
      +            "requestId": {
      +              "type": "string"
      +            },
      +            "status": {
      +              "properties": {
      +                "statusCode": {
      +                  "type": "string"
      +                }
      +              },
      +              "type": "object"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "entryPoints": {
      +          "items": {
      +            "properties": {
      +              "accessCode": {
      +                "type": "string"
      +              },
      +              "entryPointFeatures": {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "entryPointType": {
      +                "type": "string"
      +              },
      +              "label": {
      +                "type": "string"
      +              },
      +              "meetingCode": {
      +                "type": "string"
      +              },
      +              "passcode": {
      +                "type": "string"
      +              },
      +              "password": {
      +                "type": "string"
      +              },
      +              "pin": {
      +                "type": "string"
      +              },
      +              "regionCode": {
      +                "type": "string"
      +              },
      +              "uri": {
      +                "type": "string"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "notes": {
      +          "type": "string"
      +        },
      +        "parameters": {
      +          "properties": {
      +            "addOnParameters": {
      +              "properties": {
      +                "parameters": {
      +                  "type": "object"
      +                }
      +              },
      +              "type": "object"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "signature": {
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "created": {
      +      "type": "string"
      +    },
      +    "creator": {
      +      "properties": {
      +        "displayName": {
      +          "type": "string"
      +        },
      +        "email": {
      +          "type": "string"
      +        },
      +        "id": {
      +          "type": "string"
      +        },
      +        "self": {
      +          "type": "boolean"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "description": {
      +      "type": "string"
      +    },
      +    "end": {
      +      "properties": {
      +        "date": {
      +          "type": "string"
      +        },
      +        "dateTime": {
      +          "type": "string"
      +        },
      +        "timeZone": {
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "endTimeUnspecified": {
      +      "type": "boolean"
      +    },
      +    "etag": {
      +      "type": "string"
      +    },
      +    "eventLabelId": {
      +      "type": "string"
      +    },
      +    "eventType": {
      +      "type": "string"
      +    },
      +    "extendedProperties": {
      +      "properties": {
      +        "private": {
      +          "type": "object"
      +        },
      +        "shared": {
      +          "type": "object"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "focusTimeProperties": {
      +      "properties": {
      +        "autoDeclineMode": {
      +          "type": "string"
      +        },
      +        "chatStatus": {
      +          "type": "string"
      +        },
      +        "declineMessage": {
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "gadget": {
      +      "properties": {
      +        "display": {
      +          "type": "string"
      +        },
      +        "height": {
      +          "type": "integer"
      +        },
      +        "iconLink": {
      +          "type": "string"
      +        },
      +        "link": {
      +          "type": "string"
      +        },
      +        "preferences": {
      +          "type": "object"
      +        },
      +        "title": {
      +          "type": "string"
      +        },
      +        "type": {
      +          "type": "string"
      +        },
      +        "width": {
      +          "type": "integer"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "guestsCanInviteOthers": {
      +      "type": "boolean"
      +    },
      +    "guestsCanModify": {
      +      "type": "boolean"
      +    },
      +    "guestsCanSeeOtherGuests": {
      +      "type": "boolean"
      +    },
      +    "hangoutLink": {
      +      "type": "string"
      +    },
      +    "htmlLink": {
      +      "type": "string"
      +    },
      +    "iCalUID": {
      +      "type": "string"
      +    },
      +    "id": {
      +      "type": "string"
      +    },
      +    "kind": {
      +      "type": "string"
      +    },
      +    "location": {
      +      "type": "string"
      +    },
      +    "locked": {
      +      "type": "boolean"
      +    },
      +    "organizer": {
      +      "properties": {
      +        "displayName": {
      +          "type": "string"
      +        },
      +        "email": {
      +          "type": "string"
      +        },
      +        "id": {
      +          "type": "string"
      +        },
      +        "self": {
      +          "type": "boolean"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "originalStartTime": {
      +      "properties": {
      +        "date": {
      +          "type": "string"
      +        },
      +        "dateTime": {
      +          "type": "string"
      +        },
      +        "timeZone": {
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "outOfOfficeProperties": {
      +      "properties": {
      +        "autoDeclineMode": {
      +          "type": "string"
      +        },
      +        "declineMessage": {
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "privateCopy": {
      +      "type": "boolean"
      +    },
      +    "recurrence": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "recurringEventId": {
      +      "type": "string"
      +    },
      +    "reminders": {
      +      "properties": {
      +        "overrides": {
      +          "items": {
      +            "properties": {
      +              "method": {
      +                "type": "string"
      +              },
      +              "minutes": {
      +                "type": "integer"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "useDefault": {
      +          "type": "boolean"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "sequence": {
      +      "type": "integer"
      +    },
      +    "source": {
      +      "properties": {
      +        "title": {
      +          "type": "string"
      +        },
      +        "url": {
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "start": {
      +      "properties": {
      +        "date": {
      +          "type": "string"
      +        },
      +        "dateTime": {
      +          "type": "string"
      +        },
      +        "timeZone": {
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "status": {
      +      "type": "string"
      +    },
      +    "summary": {
      +      "type": "string"
      +    },
      +    "transparency": {
      +      "type": "string"
      +    },
      +    "updated": {
      +      "type": "string"
      +    },
      +    "visibility": {
      +      "type": "string"
      +    },
      +    "workingLocationProperties": {
      +      "properties": {
      +        "customLocation": {
      +          "properties": {
      +            "label": {
      +              "type": "string"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "homeOffice": {
      +          "type": "any"
      +        },
      +        "officeLocation": {
      +          "properties": {
      +            "buildingId": {
      +              "type": "string"
      +            },
      +            "deskId": {
      +              "type": "string"
      +            },
      +            "floorId": {
      +              "type": "string"
      +            },
      +            "floorSectionId": {
      +              "type": "string"
      +            },
      +            "label": {
      +              "type": "string"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "type": {
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    }
      +  },
      +  "type": "object"
      +}
  3. First observed

TDQS

B3.3/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden, and it does disclose two useful traits: patch semantics (partial update) and refusal under readonly safety profiles. However, it omits permission requirements, guest-notification side effects (the schema exposes sendUpdates but the description never mentions that updates may email guests), and the irreversibility of the mutation. The behavioral profile is therefore only partially covered.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loads 'Updates an event', which is good, but then packs several distinct ideas into one dense paragraph. The long partial field enumeration ('anyoneCanAddSelf, attachments, attendees, attendeesOmitted, birthdayProperties, colorId, conferenceData, created and 36 more fields') is wasted text when the full schema is already available, and the unqualified sibling list adds length without routing value.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so return-value explanation is not required, and the description correctly notes the response is the API's JSON resource. For a 14-parameter mutation tool with no annotations, however, it should say more about permissions, notification side effects, and what happens to fields omitted from a patch. It is adequate but leaves meaningful gaps for a write operation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the baseline is 3. The description adds little beyond the schema: it restates that the body is a JSON Event object with fields such as anyoneCanAddSelf, attachments, colorId and '36 more', and that it can be passed via `params` or `body_file` — both already documented in the request_body and body_file schema entries. It does not clarify the semantics of query parameters like sendUpdates or conferenceDataVersion.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource: 'Updates an event' plus 'supports patch semantics [HTTP PATCH]'. This distinguishes it from a full update only implicitly (patch vs update semantics), and the sibling list is presented without saying why to pick patch over calendar.events.update. Clear enough to select, but not a sharp sibling distinction.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives one usable constraint — 'refused under --readonly safety profiles' — but no explicit when-to-use guidance versus the 'update' sibling or when a patch is preferable to a full replace. The sibling enumeration ('delete, get, import, insert, instances, list, move, quickAdd, update, watch') names alternatives without saying which condition selects them, leaving routing to inference.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server

Other Tools