User Calendar Availability

the users' calendar availability can be accessed to identify suitable time slots and periods for event scheduling this feature depends on the users' https //www cronofy com connection being active in jobylon create post p2/users/calendar availability/ query string parameters none request payload the request structure is based on cronofy's https //docs cronofy com/developers/api/scheduling/availability/ name type mandatory? description duration min integer yes duration needed for the event between 1 minute and 480 minutes (8 hours) participants list yes list of participants query periods list yes list of query periods response format string no "slots" or "periods" default is "slots" participants name type mandatory? description members list yes list of members required list no either a string of "all" to specify that all members of the group need to be available for a period to be viable, or an integer to specify the minimum number of the group that must be available members name type mandatory? description email email yes email of the user query periods name type mandatory? description start datetime yes lookup initial time in the format %y %m %dt%h %m %s end datetime yes lookup final time in the format %y %m %dt%h %m %s response the response will be a list of available time slot objects name type description start datetime initial datetime of the available slot/period end datetime final datetime of the available slot/period participants list list of participants available for the slot/period exceptions status description 400 bad request invalid field format or data a user does not exist a user does not belong to a customer account accessible by the partner a user does not have an active connection to cronofy 403 permission denied 405 method not supported example curl request post \\ \ url https //staging jobylon com/p2/users/calendar availability/ \\ \ header 'content type application/json' \\ \ header 'x app id \<app id>' \\ \ header 'x app key \<app key>' \\ \ data '{ "participants" \[ { "members" \[ { "email" "peter parker\@jobylon com" }, { "email" "bruce wayne\@jobylon com" } ], "required" "all" }, { "members" \[ { "email" "diana themyscira\@jobylon com" }, { "email" "tony stark\@jobylon com" } ], "required" 1 } ], "query periods" \[ { "start" "2025 12 15t09 00 00", "end" "2025 12 20t20 00 00" }, { "start" "2025 12 22t09 00 00", "end" "2025 12 31t15 30 00" } ], "duration min" 30, "response format" "periods" }'