Create, list, update, and delete out-of-office entries in Cal.com via API v2, including forwarding bookings to a covering user.

Documented steps

1. Set Authorization: 'Bearer <cal_api_key>' on every request.
2. For the authenticated user, POST https://api.cal.com/v2/me/ooo with body {"start":"<ISO 8601 UTC datetime>","end":"<ISO 8601 UTC datetime>"} — start and end are required.
3. Optionally add reason (one of unspecified, vacation, travel, sick, public_holiday), toUserId (<number>, to forward/cover bookings during the OOO window), and notes (free-text).
4. OAuth callers need the SCHEDULE_WRITE scope for self OOO writes.
5. To create OOO for another user as an org admin, POST https://api.cal.com/v2/organizations/{orgId}/users/{userId}/ooo with the same body fields; this requires the ORG_SCHEDULE_WRITE scope.
6. Confirm the 201 response: data.id, data.uuid, data.start, data.end, and data.toUserId echo the request.
7. To list entries, GET https://api.cal.com/v2/me/ooo with optional take (1-250, default 250), skip (default 0), sortStart (asc/desc), and sortEnd (asc/desc).
8. To modify an entry, PATCH https://api.cal.com/v2/me/ooo/{oooId} with any of start, end, notes, toUserId, reason.
9. To remove an entry, DELETE https://api.cal.com/v2/me/ooo/{oooId} (requires SCHEDULE_WRITE).
10. Docs: https://cal.com/docs/api-reference/v2/out-of-office/create-an-out-of-office-entry-for-the-authenticated-user