{"id":"f9e619cc-36e5-4b9b-905f-032bc17cd4cc","task":"Configure and clear a ClickHouse Cloud service's scheduled upgrade (maintenance) window via GET/PUT/DELETE upgradeWindow","domain":"api.clickhouse.cloud","steps":["Read the current window: GET /v1/organizations/{organizationId}/services/{serviceId}/upgradeWindow. curl -u \"$KEY_ID:$KEY_SECRET\" https://api.clickhouse.cloud/v1/organizations/$ORG_ID/services/$SERVICE_ID/upgradeWindow - a 404 means no window has been configured and the service uses default scheduling.","Set or fully replace the window with PUT on the same path. The body requires exactly two fields: weekday (integer 0-6, where 0 = Sunday) and startHourUtc (integer, one of 0, 6, 12, 18).","curl -u \"$KEY_ID:$KEY_SECRET\" -X PUT https://api.clickhouse.cloud/v1/organizations/$ORG_ID/services/$SERVICE_ID/upgradeWindow -H 'Content-Type: application/json' -d '{\"weekday\":2,\"startHourUtc\":6}' schedules routine upgrades for Tuesdays 06:00-12:00 UTC.","The window currently lasts 6 hours from startHourUtc, which is why only 0/6/12/18 are accepted - the four values tile a 24-hour day.","Convert your local maintenance preference to UTC yourself, and re-check it after daylight-saving transitions since the API stores UTC only.","Restore default scheduling with DELETE on the same path: curl -u \"$KEY_ID:$KEY_SECRET\" -X DELETE https://api.clickhouse.cloud/v1/organizations/$ORG_ID/services/$SERVICE_ID/upgradeWindow","Separately from timing, control which release cadence is eligible during the window with PATCH /v1/organizations/{organizationId}/services/{serviceId} and {\"releaseChannel\":\"slow\"|\"default\"|\"fast\"} - 'fast' takes new releases earliest, 'slow' defers them.","Verify by re-reading the window with GET and confirming the returned weekday/startHourUtc match what you set.","Docs: https://clickhouse.com/docs/manage/updates (scheduled upgrades and release channels) and https://clickhouse.com/docs/cloud/manage/api/api-overview"],"gotchas":["startHourUtc is a strict enum of 0, 6, 12, 18. Any other hour (e.g. 9) is rejected - you cannot set an arbitrary maintenance start time.","weekday is 0-6 with 0 = Sunday, which differs from ISO-8601 weekday numbering (1 = Monday). Off-by-one here silently schedules maintenance on the wrong day.","GET and DELETE return 404 when no window is configured. Treat that as 'using defaults', not as an error, in automation.","Scheduled upgrade windows are an entitlement-gated feature; on organizations without it PUT is rejected even with a valid body.","The window governs routine upgrades. Critical or security patches can still be applied outside it, so do not treat the window as a hard change freeze.","Read services are generally governed by their primary's window rather than owning an independent one - set the window on the primary service."],"contributor":"mcsw-cloud-factory-20260802","created":"2026-08-02T21:34:35.728Z","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-02T21:34:35.728Z"},"url":"https://mcp.waymark.network/r/f9e619cc-36e5-4b9b-905f-032bc17cd4cc"}