# Update a status page update — API reference > Updates an existing status-page update's timing, recurrence, visibility, affected resources or publication behavior. Source: https://upfour.io/docs/api/status-pages/update-a-status-page-update [Developers](https://upfour.io/docs/api.md)/[Status pages](https://upfour.io/docs/api/status-pages.md) Updates an existing status-page update's timing, recurrence, visibility, affected resources or publication behavior. PUT https://app.upfour.io/v1/status-pages/{pageID}/updates/{updateID} scope status_page.write stable returns 200 ## Parameters | Field | Type | Description | | --- | --- | --- | | `pageID` required | uuid | path parameter | | `updateID` required | uuid | path parameter | ## Body The 3 fields most calls use come first; the rest are grouped below. `application/json` required 14 fields titlestring · nullable visibilitystring · nullable publicdraft notify_on_publishboolean When this request turns a draft public, sends its latest entry to subscribers. Affected services3 fields affected_monitor_idsuuid[] · nullable affected_resource_idsuuid[] · nullable monitor_modestring · nullable pause_checks pauses the affected monitors for the window and needs starts_at and ends_at. Only for maintenance. nonepause_checks Timing6 fields starts_atstring (date-time) · nullable Omitted leaves it unchanged; the zero time (0001-01-01T00:00:00Z) clears it. ends_atstring (date-time) · nullable Omitted leaves it unchanged; the zero time (0001-01-01T00:00:00Z) clears it. timezonestring · nullable IANA time zone of the planned window. Only for maintenance. recurrencestring · nullable Needs starts_at and ends_at. Only for maintenance. noneweeklymonthly recurrence_untilstring (date) · nullable Last day of the series (YYYY-MM-DD); empty means no end. reminder_minutesinteger · nullable 5 to 20160 minutes before the window starts; 0 switches the reminder off. Needs starts_at. Only for maintenance. Automation2 fields auto_startboolean · nullable auto_endboolean · nullable ## Returns A successful request returns `200` with application/json. Response fields 1 top-level fields | Field | Type | Description | | --- | --- | --- | | `data` | StatusPageUpdate | | | StatusPageUpdate · 38 fields FieldTypeDescription `affected_monitor_ids` uuid[] · nullable Monitors behind the affected components. `affected_resource_ids` uuid[] · nullable `auto_end` boolean `auto_start` boolean `created_at` string (date-time) `ends_at` string (date-time) · nullable `entries` StatusPageUpdateEntry[] · nullable Each item · 9 fields FieldTypeDescription `created_at` string (date-time) `id` uuid `message` string `notify_subscribers` boolean `published_at` string (date-time) `source` string one of`manual` `automatic` `status` string one of`investigating` `identified` `monitoring` `resolved` `scheduled` `in_progress` `completed` `cancelled` `published` `update_id` uuid `updated_at` string (date-time) `id` uuid `message` string Mirrors the latest entry. `monitor_mode` string one of`none` `pause_checks` `notify_subscribers` boolean `published_at` string (date-time) `recurrence` string one of`none` `weekly` `monthly` `recurrence_until` string (date) · nullable Last day of a recurring series (YYYY-MM-DD); null for no end. `reminder_minutes` integer · nullable `source` string one of`manual` `automatic` `starts_at` string (date-time) · nullable `status` string one of`investigating` `identified` `monitoring` `resolved` `scheduled` `in_progress` `completed` `cancelled` `published` Mirrors the latest entry. `status_page_id` uuid `timezone` string IANA time zone of a planned maintenance window; empty for other types. `title` string `update_type` string one of`incident` `maintenance` `report` `updated_at` string (date-time) `visibility` string one of`public` `draft` `closed_unmeasured` boolean Resolved, but the incident ended because monitoring resumed after a billing pause: nobody measured the recovery. `incident_group_id` uuid `incident_id` uuid `reminder_sent_at` string (date-time) `series_id` uuid | | | ## Errors Only the errors this operation can return. Every error uses the [same envelope](https://upfour.io/docs/api/responses.md). | Status | Code | Meaning | | --- | --- | --- | | 400 | [bad_request](https://upfour.io/docs/api/errors#code-bad_request) | The request is malformed or fails validation. | | 404 | [not_found](https://upfour.io/docs/api/errors#code-not_found) | The requested resource does not exist or is outside the caller's scope. | | 403 | [permission_denied](https://upfour.io/docs/api/errors#code-permission_denied) | The credentials do not permit this action. | Every call can also return `unauthorized` (401), `rate_limit_exceeded` (429) or `internal_error` (500 / 502). See [Responses and errors](https://upfour.io/docs/api/responses.md). [PreviousGet a status page update](https://upfour.io/docs/api/status-pages/get-a-status-page-update.md) [NextList update deliveries](https://upfour.io/docs/api/status-pages/list-update-deliveries.md) ## Request ### cURL ```bash curl -s -X PUT "https://app.upfour.io/v1/status-pages/00000000-0000-4000-8000-000000000001/updates/00000000-0000-4000-8000-000000000002" \ -H "Authorization: Bearer $UP4_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "title": "Checkout is slow" }' ``` ### JavaScript ```javascript const res = await fetch("https://app.upfour.io/v1/status-pages/00000000-0000-4000-8000-000000000001/updates/00000000-0000-4000-8000-000000000002", { method: "PUT", headers: { Authorization: `Bearer ${process.env.UP4_API_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({ title: "Checkout is slow", }), }); console.log(res.status, await res.json()); ``` ### Python ```python import os import requests res = requests.put( "https://app.upfour.io/v1/status-pages/00000000-0000-4000-8000-000000000001/updates/00000000-0000-4000-8000-000000000002", headers={"Authorization": f"Bearer {os.environ['UP4_API_KEY']}"}, json={ "title": "Checkout is slow", }, ) print(res.status_code, res.json()) ``` ### Go ```go package main import ( "fmt" "io" "net/http" "os" "strings" ) func main() { payload := strings.NewReader(`{ "title": "Checkout is slow" }`) req, _ := http.NewRequest("PUT", "https://app.upfour.io/v1/status-pages/00000000-0000-4000-8000-000000000001/updates/00000000-0000-4000-8000-000000000002", payload) req.Header.Set("Authorization", "Bearer "+os.Getenv("UP4_API_KEY")) req.Header.Set("Content-Type", "application/json") res, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer res.Body.Close() out, _ := io.ReadAll(res.Body) fmt.Println(res.StatusCode, string(out)) } ``` ### PHP ```php "PUT", CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => [ "Authorization: Bearer " . getenv("UP4_API_KEY"), "Content-Type: application/json", ], CURLOPT_POSTFIELDS => $payload, ]); $response = curl_exec($ch); echo curl_getinfo($ch, CURLINFO_RESPONSE_CODE), " ", $response, "\n"; curl_close($ch); ``` ## Response ### 200 ```json { "data": { "affected_monitor_ids": [], "affected_resource_ids": [], "auto_end": false, "auto_start": false, "created_at": "2026-10-27T09:00:00Z", "ends_at": null, "entries": [ { "created_at": "2026-10-27T09:00:00Z", "id": "00000000-0000-4000-8000-000000000003", "message": "We are looking into slow responses on the checkout.", "notify_subscribers": false, "published_at": "2026-10-27T09:00:00Z", "source": "manual", "status": "investigating", "update_id": "00000000-0000-4000-8000-000000000002", "updated_at": "2026-10-27T09:00:00Z" } ], "id": "00000000-0000-4000-8000-000000000002", "message": "We are looking into slow responses on the checkout.", "monitor_mode": "none", "notify_subscribers": false, "published_at": "2026-10-27T09:00:00Z", "recurrence": "none", "recurrence_until": null, "reminder_minutes": null, "source": "manual", "starts_at": null, "status": "investigating", "status_page_id": "00000000-0000-4000-8000-000000000001", "timezone": "", "title": "Checkout is slow", "update_type": "incident", "updated_at": "2026-10-27T09:00:00Z", "visibility": "public" } } ``` ### 400 ```json { "error": { "code": "bad_request", "message": "The request is malformed or fails validation.", "request_id": "req_…" } } ``` ### 403 ```json { "error": { "code": "permission_denied", "message": "The credentials do not permit this action.", "request_id": "req_…" } } ``` ### 404 ```json { "error": { "code": "not_found", "message": "The requested resource does not exist or is outside the caller's scope.", "request_id": "req_…" } } ```