Calendar Tools

Delete Calendar Item

Delete a calendar item identified by title and initial_date, matched at day precision. Optional selector fields can disambiguate, and the selector must resolve to exactly one item. For recurring items, apply_scope defaults to this and controls affected occurrences. This action is irreversible and requires explicit user confirmation. Write operation: deletes a calendar item.

delete/v1/mcp/tool/calendars

Request

  • Base URL: https://api.imobzi.app
  • URL: https://api.imobzi.app/v1/mcp/tool/calendars
  • Auth: API key in header X-Imobzi-Secret

Query parameters

selectorstring nullable

Serialized selector payload (JSON or dict-like string).

titlestring nullable

Calendar item title used with initial_date to identify the item. The title is matched as a phrase.

initial_datestring nullable

Reference date or datetime in ISO 8601 format. It is interpreted in America/Sao_Paulo and matched at calendar-day precision.

user_namestring nullable

Optional user filter for disambiguation.

user_emailstring nullable

Optional user email filter for disambiguation.

item_typestring nullable

Optional item type filter for disambiguation.

contact_namestring nullable

Optional contact name filter for disambiguation.

contact_emailstring nullable

Optional contact email filter for disambiguation.

property_codestring nullable

Optional property code filter for disambiguation.

property_addressstring nullable

Optional property address filter for disambiguation.

apply_scopestring nullable

Scope for a recurring item: this deletes only the selected occurrence, next deletes the selected and following occurrences, and all deletes the entire series. Default: this.

Request body

apply_scope'this' | 'next' | 'all' nullable

Scope for a recurring item: this deletes only the selected occurrence, next deletes the selected and following occurrences, and all deletes the entire series. Default: this.

Changes

No recorded changes to this operation across all 1 revision of this API.