# 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"
  }
}

POST

api

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_here

string

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"
  }
}

Get Started

Concepts

API Reference

Guides

Create Availability Rule

Create Availability Rule

Endpoint

Path parameters

Request headers

Request body

When `type: "recurring"`

When `type: "exception"`

Examples

Response

​Create Availability Rule

​Endpoint

​Path parameters

​Request headers

​Request body

​When type: "recurring"

​When type: "exception"

​Examples

​Response

Create Availability Rule

Endpoint

Path parameters

Request headers

Request body

When `type: "recurring"`

When `type: "exception"`

Examples

Response