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. 

[Nick Coates · Accepted solution]

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.

[Joshua Aldridge]

Thanks!

[Rajat Jain]

@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