Cronofy changelog
Cronofy changelog
www.cronofy.com

Availability Query Sync Statuses

 

API

 

 

The latest addition to the API helps you make scheduling decisions with greater confidence.

We now support returning a summary of participants' synchronization statuses when you are making an Availability Query.

This allows you to handle cases where stale or incomplete data (caused by authorization issues or calendar provider downtime, for example) means we can't guarantee the query has been done using a completely up-to-date view of participants' calendars.

Opt-in to this by setting the new include_member_statuses flag to true on the request:

POST /v1/availability HTTP/1.1
Host: api.cronofy.com
Authorization: Bearer {API_KEY}
Content-Type: application/json; charset=utf-8

{
  ...your availability query...
  "include_member_statuses": true
}

And you'll get the new member_statuses field in the Availability Query response:

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
  ...availability query results...
  "member_statuses": [
    {
      "sub": "acc_678347111010113",
      "sync_status": "active"
    },
    {
      "sub": "acc_545665722612031",
      "sync_status": "pending"
    },
    {
      "sub": "acc_126865445645615",
      "sync_status": "disconnected"
    }
  ]
}

As a reminder, this information is already available in a more granular form by querying accounts' Profile Information, or you may handle this case by subscribing to the profile_disconnected Push Notification; However, we expect for many workflows, this single summarized view will be more convenient.