Maintenance

A maintenance is a disruption you know about in advance. It is announced, it runs in a window, and it ends — and because it is planned, it does not count as downtime here.

The three phases

Scheduled → In progress → Completed. You can move between them by hand or leave it to us.

What you configure

• Title and message — what is happening and what customers will notice.
• Scheduled start and scheduled end — the announced window.
• Affected components.
• Actual start / actual end — filled in once the work really starts and ends. Usually automatically.
• Unlisted — see Unlisted entries.

Automation

Four switches that save you work in the middle of the night:

• Auto start — at the scheduled start it moves itself to In progress.
• Update component status — affected components go to Maintenance for the duration, then back to operational.
• Auto complete — at the scheduled end it moves to Completed.
• Reminder one hour before — an extra notification shortly before it begins.

If the work runs longer than planned, Auto complete still fires at the scheduled end. Turn it off when you want to decide yourself when it is over.

Who is notified, and when

This is finer-grained than an incident — not every maintenance deserves four emails:

• Notify subscribers — the master switch. Off means nothing is sent, whatever is set below.
• On announcement — when the maintenance is created.
• Reminder one hour before
• On start
• On completion

A nightly window with no customer impact usually needs only the announcement. A migration with downtime wants all four.

After the maintenance

A completed maintenance stays visible: in the timeline on the status page, among the incidents by day, and in the history under Past maintenance. Unlisted maintenances and those still waiting for approval do not appear there.

Calendar feed

Every status page has an iCal feed at /calendar.ics carrying scheduled and recently past maintenances. Customers subscribe once and have your windows in their own calendar — considerably more reliable than finding an email again at the right moment.

The page footer links to subscribe, including one straight into Google Calendar. The feed can be turned off under Subscriptions → RSS/Calendar.

Checks during maintenance

If a check belongs to an affected component, it does not alert while the maintenance is in progress: expected failures count neither as an outage nor against uptime. If the service is still unreachable once it has ended, the check alerts as usual.

Approval by a second person

With four-eyes approval switched on for your status page, a new maintenance is only announced once somebody else has approved it.

Templates

A monthly maintenance window is worth a template — automation switches included.

Through the API

curl -X POST https://statuswerk.eu/api/v1/maintenances \
  -H "Authorization: Bearer $STATUSWERK_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Database upgrade",
    "message": "Brief interruptions possible.",
    "scheduled_start_at": "2026-10-01T22:00:00+02:00",
    "scheduled_end_at": "2026-10-02T00:00:00+02:00",
    "auto_start": true,
    "auto_complete": true
  }'

Full detail in the API reference.