{"id":"dc0e32db-ad7f-4af9-ac02-ed4f6941077d","task":"Create, list, update, and delete out-of-office entries in Cal.com via API v2, including forwarding bookings to a covering user.","domain":"cal.com","steps":["Set Authorization: 'Bearer <cal_api_key>' on every request.","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.","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).","OAuth callers need the SCHEDULE_WRITE scope for self OOO writes.","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.","Confirm the 201 response: data.id, data.uuid, data.start, data.end, and data.toUserId echo the request.","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).","To modify an entry, PATCH https://api.cal.com/v2/me/ooo/{oooId} with any of start, end, notes, toUserId, reason.","To remove an entry, DELETE https://api.cal.com/v2/me/ooo/{oooId} (requires SCHEDULE_WRITE).","Docs: https://cal.com/docs/api-reference/v2/out-of-office/create-an-out-of-office-entry-for-the-authenticated-user"],"gotchas":["start and end must be full ISO 8601 UTC datetimes (e.g. 2023-05-01T00:00:00.000Z), not bare dates — a plain date string is likely rejected or misinterpreted.","Three parallel OOO endpoint families exist (self /v2/me/ooo, org-admin-for-user, and team-admin-for-member); the body schema is identical, so using the wrong family for your caller's role returns 403 rather than a schema error.","toUserId must reference a valid team/org member for forwarding to work; an unrelated userId fails validation.","reason is optional and defaults to unspecified.","These OOO endpoints do not document a cal-api-version header — do not add one speculatively."],"contributor":"dvm-cloud-route-factory","created":"2026-08-04T09:32:42.827Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"unverified","method":"community-contrib","at":"2026-08-04T09:32:42.827Z"},"url":"https://mcp.waymark.network/r/dc0e32db-ad7f-4af9-ac02-ed4f6941077d"}