# Create a status page report — API reference > Creates a status-page report with a title, message, affected resources and optional subscriber notification. Source: https://upfour.io/docs/api/status-pages/create-a-status-page-report [Developers](https://upfour.io/docs/api.md)/[Status pages](https://upfour.io/docs/api/status-pages.md) Creates a status-page report with a title, message, affected resources and optional subscriber notification. POST https://app.upfour.io/v1/status-pages/{pageID}/reports scope status_page.write stable [Idempotency-Key supported](https://upfour.io/docs/api/idempotency.md) returns 201 ## Parameters | Field | Type | Description | | --- | --- | --- | | `pageID` required | uuid | path parameter | ## Body The 5 fields most calls use come first; the rest are grouped below. `application/json` required 18 fields titlestring (required) messagestring statusstring Valid values depend on update_type: investigating, identified, monitoring or resolved for incidents; scheduled, in_progress, completed or cancelled for maintenance; published for reports. Defaults to the first of those. investigatingidentifiedmonitoringresolvedscheduledin_progresscompletedcancelledpublished update_typestring incident (the default), maintenance or report. Ignored by POST /status-pages/{pageID}/reports, which always creates a report. The service does not validate it; any other value behaves like incident. incidentmaintenancereport visibilitystring public (the default) or draft for a thread still being prepared. publicdraft Affected services3 fields affected_monitor_idsuuid[] Monitors the update affects; read only when affected_resource_ids is empty. affected_resource_idsuuid[] Components (not monitors) the update affects. Wins over affected_monitor_ids when both are given. 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 ends_atstring (date-time) · nullable 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. Automation4 fields auto_startboolean auto_endboolean notify_subscribersboolean published_atstring (date-time) · nullable Backdates the display time of an incident or report; not in the future. Ignored for maintenance. ## Returns A successful request returns `201` 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. | | 409 | documented response | `idempotency_key_conflict`: the `Idempotency-Key` was already used with a different request body; `idempotency_replay_unavailable`: the stored response can no longer be replayed for this credential or resource, refresh the state instead of retrying with a new key. | 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). [PreviousList status page reports](https://upfour.io/docs/api/status-pages/list-status-page-reports.md) [NextList status page sections](https://upfour.io/docs/api/status-pages/list-status-page-sections.md) ## Request ### cURL ```bash curl -s -X POST "https://app.upfour.io/v1/status-pages/00000000-0000-4000-8000-000000000001/reports" \ -H "Authorization: Bearer $UP4_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "message": "The checkout was unavailable for 12 minutes.", "notify_subscribers": false, "status": "published", "title": "Checkout outage", "update_type": "report" }' ``` ### JavaScript ```javascript const res = await fetch("https://app.upfour.io/v1/status-pages/00000000-0000-4000-8000-000000000001/reports", { method: "POST", headers: { Authorization: `Bearer ${process.env.UP4_API_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({ message: "The checkout was unavailable for 12 minutes.", notify_subscribers: false, status: "published", title: "Checkout outage", update_type: "report", }), }); console.log(res.status, await res.json()); ``` ### Python ```python import os import requests res = requests.post( "https://app.upfour.io/v1/status-pages/00000000-0000-4000-8000-000000000001/reports", headers={"Authorization": f"Bearer {os.environ['UP4_API_KEY']}"}, json={ "message": "The checkout was unavailable for 12 minutes.", "notify_subscribers": False, "status": "published", "title": "Checkout outage", "update_type": "report", }, ) print(res.status_code, res.json()) ``` ### Go ```go package main import ( "fmt" "io" "net/http" "os" "strings" ) func main() { payload := strings.NewReader(`{ "message": "The checkout was unavailable for 12 minutes.", "notify_subscribers": false, "status": "published", "title": "Checkout outage", "update_type": "report" }`) req, _ := http.NewRequest("POST", "https://app.upfour.io/v1/status-pages/00000000-0000-4000-8000-000000000001/reports", 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 "POST", 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 ### 201 ```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-000000000002", "message": "The checkout was unavailable for 12 minutes.", "notify_subscribers": false, "published_at": "2026-10-27T09:00:00Z", "source": "manual", "status": "published", "update_id": "00000000-0000-4000-8000-000000000003", "updated_at": "2026-10-27T09:00:00Z" } ], "id": "00000000-0000-4000-8000-000000000003", "message": "The checkout was unavailable for 12 minutes.", "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": "published", "status_page_id": "00000000-0000-4000-8000-000000000001", "timezone": "", "title": "Checkout outage", "update_type": "report", "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_…" } } ```