Find free appointment slots in a connected calendar, without any saved agent configuration; windows defaults to 24 hours every day when omitted

Returns free slots in a connected calendar WITHOUT any saved agent - the same computation as check_availability during a call, just without the agent's rules. windows omitted means 24 hours every day; if you send it, a weekday left out has no window. to must be after from and at most 31 days later. The response carries only start/end and timezone - no event titles or descriptions.

post/v1/integrations/{id}/availability

Request

  • Base URL: https://volai.cz
  • URL: https://volai.cz/v1/integrations/{id}/availability
  • Auth: HTTP bearer

Path parameters

idstring required

Request body

calendarIdstring required

Calendar id from list_calendars, for example primary.

busyCalendarIdsstring[]

Other calendars in the same connection whose events also block a slot; nothing is written into them, so read-only calendars are fine. At most 4, without duplicates and without calendarId itself.

fromstring date-time required

Lower bound of the search window, RFC 3339 with an offset.

tostring date-time required

Upper bound of the search window, RFC 3339 with an offset. Must be after from and at most 31 days later, otherwise calendar_invalid_range.

minNoticeMinutesinteger

Minimum notice before the earliest offered slot, in minutes. Defaults to 120.

bufferMinutesinteger

Buffer kept free immediately before and after every busy event, in minutes. Defaults to 0.

timezonestring

IANA timezone the windows and returned slots are interpreted in. Defaults to Europe/Prague.

limitinteger

Maximum number of slots to return, 1 to 50. Defaults to 20.

Response

Free slots (start/end only, no title or description) and the timezone they are in

timezonestring required

Changes

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