nav[aria-label="Primary Navigation"] { padding: 0; & ul { list-style: none; width: 100%; display: flex; flex-direction: row; justify-content: start; align-items: start; gap: 30px; padding: 0; & li { margin: 0; } & ul li { list-style: none; } } }

Create Maintenance Event via API

Joshua Aldridge

Has anyone created maintenance posts to statuspage from the API? The goal is to automate a webhook from JIRA or another tool for the purposes of change management. I don't see anything about creating a maintenance post from the documentation, only incidents.

Accepted answers

Nick Coates

Hi @Joshua Aldridge

Maintenances are a type of Incident when it comes to Statuspage. You'll need to call the 'Create an incident' API endpoint. You then have options to add in the scheduled dates/times, scheduled automation etc.

More information here: https://developer.statuspage.io/#operation/postPagesPageIdIncidents

Hope this helps.

Thanks,
Nick Coates
Statuspage Product Owner, Broadcom Inc.

All comments

Nick Coates

Hi @Joshua Aldridge

More information here: https://developer.statuspage.io/#operation/postPagesPageIdIncidents

Hope this helps.

Thanks,
Nick Coates
Statuspage Product Owner, Broadcom Inc.

Joshua Aldridge

Thanks!

Rajat Jain_lrgz5x

@Nick Coates Can we have an example of scheduling Maintenance using "Create an incident" API

curl https://api.statuspage.io/v1/pages/<page_id>/incidents \ 
-H "Authorization: OAuth <API_KEY>" \
-X POST \
-d "incident[name]=fakemaintenance" \
-d "incident[status]=scheduled" \
-d "incident[body]=faking maintenance" \
-d "incident[scheduled_for]=2021-08-012T06:00:00.007Z" \
-d "incident[scheduled_until]=2021-08-012T08:00:00.007Z"

I am getting an error here

{"error":"incident[scheduled_for] is invalid, incident[scheduled_until] is invalid

This might be a small syntax issue, But it would be better to have an example for maintenance in official doc