/v1/calendar/eventsRead the calendar
The caller's own calendar between two instants (from, to - RFC3339), read live from whichever vendor they connected (Google or Microsoft); entries this service booked carry `ours` with the record they are about. This read also rings due meeting reminders and clears meetings deleted at the vendor, so it is not a cheap poll. Pass definitionKey instead to list RECORDS' meetings out of our own table, which reaches no vendor at all: with one rowId for one record, rowId repeated for several, or no rowId for every record on the page — "meetings on all my leads" or "which of these have a demo booked" is ONE call, never one per record; each meeting carries its rowId. account (an address) reads that one connected calendar; without it the read goes through the first that works and says so in accounts — every connected calendar with its state: read, ready, reconnect (its grant was refused: ask the person to reconnect it in Settings › Account) or no_calendar_scope. When a meeting is not where you expected, read accounts before saying there is none.
Access class: workspace.
Send request
Use the documented inputs to call this endpoint directly.
Parameters
Values are applied to the request and the example on the right.
Responses
the action's answer
{}a refusal: {"error": "<what a person needs to read>"}. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.
{
"error": "string"
}