Post Status Page Maintenance Update

POST /api/status-pages/maintenances/{id}/updates

Adds a public update to a maintenance, before, during or after it.

AccessCopy Anchor Link

Organization admin and editor. A customer-scoped user or API token only reaches maintenance whose status pages all belong to a customer in its scope; a page without a customer (customerId: null) is for organization-wide roles only. Maintenance of another organization answers 404 (statusPageMaintenanceNotFound). Path ids take the numeric id or the publicId. The change is written to the organization's audit log.

Request BodyCopy Anchor Link

Example (cURL)Copy Anchor Link

BASE_URL="https://uptimeify.io"
TOKEN="<your-api-token>"

curl -X POST "$BASE_URL/api/status-pages/maintenances/12/updates" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"body": "The upgrade takes 20 minutes longer than planned."}'

ResponseCopy Anchor Link

201 Created:

{
  "id": 31,
  "publicId": "7c2d4e6f-8a9b-4c0d-9e1f-2a3b4c5d6e7f",
  "body": "The upgrade takes 20 minutes longer than planned.",
  "createdAt": "2026-11-03T22:40:00.000Z"
}

Common errorsCopy Anchor Link

• 400 Bad Request (invalidRequestBody) when a field is missing, has the wrong type or is unknown; data.issues names the field
• 400 Bad Request (invalidIdentifier) when an id is neither a number nor a UUID
• 401 Unauthorized when you are not logged in
• 403 Forbidden (forbidden) when your role may not do this, or for a customer-scoped caller on a page without a customer or of another customer
• 403 Forbidden (statusPagesModuleDisabled) when the status pages module is not activated
• 404 Not Found (statusPageMaintenanceNotFound) when the maintenance does not exist or belongs to another organization
• 409 Conflict (statusPageMaintenanceClosed) when the maintenance was cancelled