Managed Availability
Required plan: EmergingManaged Availability is Cronofy’s service to allow your app to capture availability rules and periods for your users.
- Availability Rules are for recurring, eg: weekly, periods like working hours.
- Available Periods for one off available periods, eg: specific interview slot options.
Using these, you can impact on a user’s availability when using the Real-Time Scheduling and Availability endpoints.
Rather than the available periods being fixed as part of those requests, when you signal that managed availability should be used for a member, their managed availability is referenced dynamically.
Example Availability Request #
POST /v1/availability HTTP/1.1
Host: {data_center_url}
Authorization: Bearer {ACCESS_TOKEN}
Content-Type: application/json; charset=utf-8
{
"participants": [
{
"members": [
{
"sub": "acc_5ba21743f408617d1269ea1e",
"managed_availability": true
},
{
"sub": "acc_64b17d868090ea21640c914c",
"managed_availability": true,
"availability_rule_ids": ["houston-office"]
}
],
"required": "all"
}
],
"required_duration": { "minutes": 60 },
"query_periods": [
{
"start": "2024-10-31T00:00:00Z",
"end": "2024-11-02T23:59:59Z"
}
]
}
See the Availability API for full docs.