Free/Busy Time Slots

Question and Answers
, ,
1

Looking at the Python SDK, specifically with the TimeSlots.status, the value is ‘typically “busy”’.

  1. What are the other possible values?
  2. Does the free/busy support also fetching events/time slots that are set as “Free”?
    1. If not, is the only way to get these via the Events API?

Thank you!

2

Hello,

The Free/Busy endpoint is designed to return only the busy time ranges. Free time is represented implicitly, any time range not covered by a returned time slot is free.

Each event has a busy boolean field (true = busy, false = free). You can fetch all events via GET /v3/grants/{id}/events and check the busy field to find events where the user’s status is set to “Free” (busy: false). There’s no way to filter by busy status in the query parameters, so you’d need to fetch events for the time range and filter client-side.

Many thanks,
Samuel R.
Support Engineer, Nylas

3

Thank you for confirming!