Docs

Type a word or a question. Esc closes the search.

Sign in Start free

Add an update entry

Adds an entry to a status-page update with a status, message and optional subscriber notification.

POST https://app.upfour.io/v1/status-pages/{pageID}/updates/{updateID}/entries
POST https://app.upfour.io/v1/status-pages/{pageID}/updates/{updateID}/entries

A real request. Sending it changes data in your up4 account.

Authorization
AuthorizationA pls_ key. It stays in this browser tab. Needs status_page.write.
Path
Body
More fields4
cancel_series With a cancelled entry, also stops the recurring series instead of only skipping this window.
notify_subscribers
Headers

Sent directly from your browser to https://app.upfour.io/v1. Mutating calls get an automatic Idempotency-Key when the field is empty.

Request
Responsenot sent yet
Fill in a key and press Send request (⌘↵).
The answer appears here.
scope status_page.write stable Idempotency-Key supported returns 201

Parameters

FieldTypeDescription
pageID required uuid path parameter
updateID required uuid path parameter

Body

application/json required 5 fields

statusstringrequired
investigatingidentifiedmonitoringresolvedscheduledin_progresscompletedcancelledpublished
All other fields4 fields
cancel_seriesboolean

With a cancelled entry, also stops the recurring series instead of only skipping this window.

messagestring
notify_subscribersboolean
published_atstring (date-time) · nullable

Backdates the entry; not in the future. Ignored for maintenance.

Returns

A successful request returns 201 with application/json.

Response fields 1 top-level fields
FieldTypeDescription
data StatusPageUpdateEntry
StatusPageUpdateEntry · 9 fields
FieldTypeDescription
created_at string (date-time)
id uuid
message string
notify_subscribers boolean
published_at string (date-time)
source string one ofmanualautomatic
status string one ofinvestigatingidentifiedmonitoringresolvedscheduledin_progresscompletedcancelledpublished
update_id uuid
updated_at string (date-time)

Errors

Only the errors this operation can return. Every error uses the same envelope.

Status Code Meaning
400 bad_request The request is malformed or fails validation.
404 not_found The requested resource does not exist or is outside the caller's scope.
403 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.