# Recurring weekday window
curl -X POST "https://app.talkover.ai/api/v1/calendars/calendar-uuid-1/availability-rules" \
-H "Authorization: Bearer talq_your_environment_token_here" \
-H "Content-Type: application/json" \
-d '{
"type": "recurring",
"days_of_week": [1, 2, 3, 4, 5],
"start_time": "09:00",
"end_time": "17:00"
}'
# Holiday exception (block Dec 25)
curl -X POST "https://app.talkover.ai/api/v1/calendars/calendar-uuid-1/availability-rules" \
-H "Authorization: Bearer talq_your_environment_token_here" \
-H "Content-Type: application/json" \
-d '{ "type": "exception", "date": "2024-12-25", "available": false }'
{
"success": true,
"data": {
"id": "rule-uuid-1",
"type": "recurring",
"days_of_week": [1, 2, 3, 4, 5],
"start_time": "09:00",
"end_time": "17:00"
}
}
Availability
Create Availability Rule
Add a recurring or exception availability rule
POST
/
api
/
v1
/
calendars
/
{calendar_id}
/
availability-rules
# Recurring weekday window
curl -X POST "https://app.talkover.ai/api/v1/calendars/calendar-uuid-1/availability-rules" \
-H "Authorization: Bearer talq_your_environment_token_here" \
-H "Content-Type: application/json" \
-d '{
"type": "recurring",
"days_of_week": [1, 2, 3, 4, 5],
"start_time": "09:00",
"end_time": "17:00"
}'
# Holiday exception (block Dec 25)
curl -X POST "https://app.talkover.ai/api/v1/calendars/calendar-uuid-1/availability-rules" \
-H "Authorization: Bearer talq_your_environment_token_here" \
-H "Content-Type: application/json" \
-d '{ "type": "exception", "date": "2024-12-25", "available": false }'
{
"success": true,
"data": {
"id": "rule-uuid-1",
"type": "recurring",
"days_of_week": [1, 2, 3, 4, 5],
"start_time": "09:00",
"end_time": "17:00"
}
}
Create Availability Rule
Add an availability rule (recurring window or exception date) to a calendar.Endpoint
POST /api/v1/calendars/{calendar_id}/availability-rules
Path parameters
string
required
Calendar UUID.
Request headers
string
required
Bearer token. Format:
Bearer talq_your_environment_token_herestring
required
Must be
application/json.Request body
string
required
Rule type. Options:
recurring, exception.When type: "recurring"
array
required
Array of weekday numbers (
1=Mon . 7=Sun).string
required
Window start. Format:
HH:MM.string
required
Window end. Format:
HH:MM.string
IANA timezone. Defaults to calendar’s timezone.
When type: "exception"
string
required
Date of exception. Format:
YYYY-MM-DD.boolean
required
Whether this date is available (overrides recurring rules) or blocked.
Examples
# Recurring weekday window
curl -X POST "https://app.talkover.ai/api/v1/calendars/calendar-uuid-1/availability-rules" \
-H "Authorization: Bearer talq_your_environment_token_here" \
-H "Content-Type: application/json" \
-d '{
"type": "recurring",
"days_of_week": [1, 2, 3, 4, 5],
"start_time": "09:00",
"end_time": "17:00"
}'
# Holiday exception (block Dec 25)
curl -X POST "https://app.talkover.ai/api/v1/calendars/calendar-uuid-1/availability-rules" \
-H "Authorization: Bearer talq_your_environment_token_here" \
-H "Content-Type: application/json" \
-d '{ "type": "exception", "date": "2024-12-25", "available": false }'
Response
{
"success": true,
"data": {
"id": "rule-uuid-1",
"type": "recurring",
"days_of_week": [1, 2, 3, 4, 5],
"start_time": "09:00",
"end_time": "17:00"
}
}
Was this page helpful?