graph_list_event_instances
Lists occurrences of a recurring calendar event within a date range, returning occurrence IDs so you can update or cancel individual instances.
Instructions
List the occurrences of a recurring event in a date range.
Pass the series master event ID from graph_list_events, then use the returned occurrence IDs to update or cancel a single occurrence.
Args: event_id: The recurring series master event ID. start_datetime: Start of the occurrence window (ISO 8601). Required by Graph. end_datetime: End of the occurrence window (ISO 8601). Required by Graph. top: Maximum number of occurrences to return (default 50, maximum 50). skip: Number of items to skip before returning results (default 0). Graph returns at most 50 per call, so page by raising skip in steps of top. compact: Whether to return only the identifying fields instead of the full record (default false). Use it to page through large collections cheaply. next_link: Opaque nextLink URL from a previous call, used to fetch the next page. Overrides the other paging arguments when supplied. include_next_link: Whether to wrap the result as {items, next_link} so paging can continue (default false, which returns a bare list). user: Shared or delegated calendar owner address or user ID to act on. Empty targets your own calendar. Requires the delegated Calendars.Read.Shared or Calendars.ReadWrite.Shared permissions.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"event_id": "<event_id>",
"start_datetime": "<start_datetime>",
"end_datetime": "<end_datetime>"
},
"name": "graph_list_event_instances"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| top | No | ||
| skip | No | ||
| user | No | ||
| compact | No | ||
| event_id | Yes | ||
| next_link | No | ||
| end_datetime | Yes | ||
| start_datetime | Yes | ||
| include_next_link | No |