Create maintenance
instatus_create_maintenanceDestructive
CREATES a new scheduled maintenance — this MODIFIES live status-page data and can notify subscribers. Provide name (required); optionally set message, affected components, per-component impact via statuses, status, start/end, duration, and notify. Instatus: POST /v1/{page_id}/maintenances. Returns the created maintenance.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | ISO 8601 timestamp for when the maintenance ends. | |
| name | Yes | Maintenance title (required). | |
| start | No | ISO 8601 timestamp for when the maintenance starts. | |
| notify | No | Whether to notify subscribers about this update. | |
| status | No | Maintenance status. | |
| message | No | Maintenance update message (Markdown supported). | |
| page_id | Yes | The status page's id. | |
| duration | No | Maintenance duration in minutes. | |
| statuses | No | Per-component impact — set each listed component's status for this event. | |
| components | No | Component ids affected by this maintenance. |