Back to Outlook Calendar
Connect Knoon AI with Outlook Calendar (Microsoft) to automate AI workflows.
List availability for booking in a calendar.
microsoftOutlookCalendarListAvailability
BETA
Permissions
Optional permissions
There are no items to display.
Parameters
| Name | Type | Description | Required |
|---|---|---|---|
| calendarId | file | ID of the calendar to search. | Yes |
| start | mustache | Window start in ISO 8601 (e.g. "2025-11-20T09:00:00+08:00" or "2025-11-20T09:00:00"). Offset (if present) is used as the reference timezone. | Yes |
| end | mustache | Window end in ISO 8601. Must be after start. Offset (if present) is used as the reference timezone. | Yes |
| enforceWorkingHours | boolean | When true, clamp availability to the mailbox working hours. | No |
| durationMinutes | mustache | Duration (in minutes) to test whether a free range can fit, e.g. "30". | Yes |
Returns
| Name | Type | Description |
|---|---|---|
| start | string | Range start in ISO 8601. |
| end | string | Range end in ISO 8601. |
| availability | string | Availability label for the range (one of "free", "busy", "unavailable" when durationMinutes cannot fit). |
| durationMinutes | number | Requested duration (in minutes) used for fit evaluation. |
| dayOfWeekLocal | string | Day of week for the range start in the requested/local timezone (e.g. "Monday"). |
| dayOfWeekUTC | string | Day of week for the range start in UTC (e.g. "Monday"). |