Auto backup: 2026-02-19 12:11

skills/api-gateway/references/cal-com.md

@@ -0,0 +1,216 @@
+# Cal.com Routing Reference
+
+**App name:** `cal-com`
+**Base URL proxied:** `api.cal.com`
+
+## API Path Pattern
+
+```
+/cal-com/v2/{resource}
+```
+
+## Common Endpoints
+
+### User Profile
+
+#### Get Profile
+```bash
+GET /cal-com/v2/me
+```
+
+#### Update Profile
+```bash
+PATCH /cal-com/v2/me
+```
+
+### Event Types
+
+#### List Event Types
+```bash
+GET /cal-com/v2/event-types
+```
+
+#### Get Event Type
+```bash
+GET /cal-com/v2/event-types/{eventTypeId}
+```
+
+#### Create Event Type
+```bash
+POST /cal-com/v2/event-types
+```
+
+#### Update Event Type
+```bash
+PATCH /cal-com/v2/event-types/{eventTypeId}
+```
+
+#### Delete Event Type
+```bash
+DELETE /cal-com/v2/event-types/{eventTypeId}
+```
+
+### Event Type Webhooks
+
+#### List Webhooks
+```bash
+GET /cal-com/v2/event-types/{eventTypeId}/webhooks
+```
+
+#### Create Webhook
+```bash
+POST /cal-com/v2/event-types/{eventTypeId}/webhooks
+```
+
+#### Get Webhook
+```bash
+GET /cal-com/v2/event-types/{eventTypeId}/webhooks/{webhookId}
+```
+
+#### Update Webhook
+```bash
+PATCH /cal-com/v2/event-types/{eventTypeId}/webhooks/{webhookId}
+```
+
+#### Delete Webhook
+```bash
+DELETE /cal-com/v2/event-types/{eventTypeId}/webhooks/{webhookId}
+```
+
+### Bookings
+
+#### List Bookings
+```bash
+GET /cal-com/v2/bookings
+GET /cal-com/v2/bookings?status=upcoming
+GET /cal-com/v2/bookings?status=past
+GET /cal-com/v2/bookings?status=cancelled
+GET /cal-com/v2/bookings?take=10
+```
+
+#### Get Booking
+```bash
+GET /cal-com/v2/bookings/{bookingUid}
+```
+
+#### Create Booking
+```bash
+POST /cal-com/v2/bookings
+```
+
+#### Cancel Booking
+```bash
+POST /cal-com/v2/bookings/{bookingUid}/cancel
+```
+
+### Schedules
+
+#### Get Default Schedule
+```bash
+GET /cal-com/v2/schedules/default
+```
+
+#### Get Schedule
+```bash
+GET /cal-com/v2/schedules/{scheduleId}
+```
+
+#### Create Schedule
+```bash
+POST /cal-com/v2/schedules
+```
+
+#### Update Schedule
+```bash
+PATCH /cal-com/v2/schedules/{scheduleId}
+```
+
+#### Delete Schedule
+```bash
+DELETE /cal-com/v2/schedules/{scheduleId}
+```
+
+### Availability Slots
+
+#### Get Available Slots
+```bash
+GET /cal-com/v2/slots/available?eventTypeId={id}&startTime={iso8601}&endTime={iso8601}
+```
+
+#### Reserve Slot
+```bash
+POST /cal-com/v2/slots/reserve
+```
+
+### Calendars
+
+#### List Connected Calendars
+```bash
+GET /cal-com/v2/calendars
+```
+
+### Conferencing
+
+#### List Conferencing Apps
+```bash
+GET /cal-com/v2/conferencing
+```
+
+#### Get Default Conferencing App
+```bash
+GET /cal-com/v2/conferencing/default
+```
+
+### Webhooks (User-level)
+
+#### List Webhooks
+```bash
+GET /cal-com/v2/webhooks
+```
+
+#### Create Webhook
+```bash
+POST /cal-com/v2/webhooks
+```
+
+#### Get Webhook
+```bash
+GET /cal-com/v2/webhooks/{webhookId}
+```
+
+#### Update Webhook
+```bash
+PATCH /cal-com/v2/webhooks/{webhookId}
+```
+
+#### Delete Webhook
+```bash
+DELETE /cal-com/v2/webhooks/{webhookId}
+```
+
+### Teams
+
+#### List Teams
+```bash
+GET /cal-com/v2/teams
+```
+
+### Verified Resources
+
+#### List Verified Emails
+```bash
+GET /cal-com/v2/verified-resources/emails
+```
+
+## Notes
+
+- All API endpoints are v2
+- All times are in UTC (ISO 8601 format)
+- Booking creation requires an available slot - check `/v2/slots/available` first
+- Required fields for booking: `eventTypeId`, `start`, `timeZone`, `language`, `responses.name`, `responses.email`
+- `GET /v2/schedules` may return 500 errors; use `GET /v2/schedules/{id}` instead
+- Event type creation requires: `title`, `slug`, `length` (in minutes)
+
+## Resources
+
+- [Cal.com API Documentation](https://cal.com/docs/api-reference/v2/introduction)