Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Cal.com Schedules API

The Schedules API from Cal.com — 3 operation(s) for schedules.

Cal.com Schedules API is one of 22 APIs that Cal.com publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.

Tagged areas include Schedules. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and an AsyncAPI specification.

This API exposes 6 operations across 3 paths, and defines 11 schemas. It is described by OpenAPI 3.0.0, at version 1.0.0.

Requests are made against the base URL https://api.cal.com/v2.

6 operations 3 paths 11 schemas 1 DELETE3 GET1 PATCH1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
1.0.0
Base URL
https://api.cal.com/v2
Resource Areas
1

Paths & Operations 6

Across 3 paths, the API surfaces 6 operations — 1 DELETE, 3 GET, 1 PATCH, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Schedules 6
POST
/v2/schedules
Create a schedule
SchedulesController_2024_06_11_createSchedule 2 params body → 201
GET
/v2/schedules
Get all schedules
SchedulesController_2024_06_11_getSchedules 2 params → 200
GET
/v2/schedules/default
Get default schedule
SchedulesController_2024_06_11_getDefaultSchedule 2 params → 200
GET
/v2/schedules/{scheduleId}
Get a schedule
SchedulesController_2024_06_11_getSchedule 3 params → 200
PATCH
/v2/schedules/{scheduleId}
Update a schedule
SchedulesController_2024_06_11_updateSchedule 3 params body → 200
DELETE
/v2/schedules/{scheduleId}
Delete a schedule
SchedulesController_2024_06_11_deleteSchedule 3 params → 200

Schemas 11

The contract defines 11 schemas that model the data the API accepts and returns. The most detailed are ScheduleOutput_2024_06_11 (7 properties), CreateScheduleInput_2024_06_11 (5 properties), UpdateScheduleInput_2024_06_11 (5 properties), ScheduleOverrideInput_2024_06_11 (3 properties). Each schema is shown below with its type and property counts.

ScheduleOverrideInput_2024_06_11
object
3 properties 3 required
CreateScheduleInput_2024_06_11
object
5 properties 3 required
GetScheduleOutput_2024_06_11
object
3 properties 2 required
DeleteScheduleOutput_2024_06_11
object
1 property 1 required
UpdateScheduleInput_2024_06_11
object
5 properties
GetDefaultScheduleOutput_2024_06_11
object
2 properties 2 required
GetSchedulesOutput_2024_06_11
object
3 properties 2 required
ScheduleAvailabilityInput_2024_06_11
object
3 properties 3 required
UpdateScheduleOutput_2024_06_11
object
3 properties 2 required
ScheduleOutput_2024_06_11
object
7 properties 7 required
CreateScheduleOutput_2024_06_11
object
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

cal-com-schedules-api-openapi.yml Raw ↑

Other APIs Cal.com publishes across the network.

Cal.com Api Keys API
Cal.com Bookings API
Cal.com Bookings / Attendees API
Cal.com Bookings / Guests API
Cal.com Cal Unified Calendars API
Cal.com Calendars API
Cal.com Conferencing API
Cal.com Deprecated: Platform / Managed Users API
Cal.com Deprecated: Platform OAuth Clients API
Cal.com Deprecated: Platform / Webhooks API
Cal.com Destination Calendars API
Cal.com Event Types API