delete_event

This reference is generated from the published tool contract.

Behavior and boundaries

Permanently deletes exactly one event identified by calendarId and eventId. For an occurrence of a series, also pass the occurrenceId from the same list_events or search_events result: only that occurrence is removed and the series continues. Immediately before deletion, the provider must confirm that the event or series is organizer-owned without guests or conference data; other events are rejected. Use list_events first and proceed only when exactly one intended event matches and canEdit=true. Repeating the same deletion is safe.

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
    }
  },
  "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"
    },
    "changed": {
      "type": "boolean"
    }
  },
  "required": [
    "ok",
    "eventId",
    "changed"
  ],
  "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