Skip to main content
Glama

calendar.events.update

Updates an existing Google Calendar event by calendar ID and event ID, replacing event fields from a JSON body and optionally notifying guests of changes.

Instructions

Updates an event [HTTP PUT] — 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, patch, quickAdd, 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

A3.7/5.0
Behavior4/5

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

With no annotations, the description carries the full burden and does disclose mutation behavior, the read-only-profile refusal, the returned resource as JSON, and the two body-delivery paths. It omits guest-notification side effects and permission requirements, which matter for an event update.

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

Conciseness4/5

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

The semantic core (verb, scope, PUT, refusal, return) is front-loaded in the first sentences. The long field enumeration and ten-name sibling list are borderline filler, but structurally the description degrades gracefully from essential to optional.

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

Completeness4/5

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

For a 14-parameter mutation tool with a rich schema and an output schema, the description covers the body-construction decision, the safety profile, and the return value. Missing pieces are the full-vs-partial replacement rule and notification side effects, which are the main risks of miscalling it.

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 coverage is 100% and the schema already spells out params vs body_file and every query parameter, so the description adds little beyond restating the body mechanism. The 'and 36 more fields' enumeration is a partial restatement of the nested Event schema rather than new meaning.

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 [HTTP PUT]') and the PUT label conveys full-replacement semantics that separates it from calendar.events.patch. It stops short of naming the patch alternative as the choice for partial edits, so the agent must infer that 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?

'Refused under --readonly safety profiles' is a real precondition and the sibling list signals the available alternatives. However, it only enumerates siblings rather than telling the agent when to prefer patch, move, or instances over this full-replacement update.

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