Statuspal API V2 Changes
Statuspal API V2 is now out of Beta, and so we won't be introducing more breaking changes to it going foreword.
You can find its documentation here: https://statuspal.io/api-docs/v2/.
Changes Introduced in API V2
Our API V2 greatly improves upon our previous API version, it makes endpoints more intuitive and uniform, as well removing some inconsistencies.
1. All dates are formatted in ISO 8601 standard
It was brought to our attention that dates were displayed in different formats across our API V1, this is now fixed in API V2, all dates now follow the ISO 8601 standard (
/summary endpoint replaces
An new API endpoint /summary has been introduced, which replaces the /status endpoint present in API V1.
The new /summary endpoint is similar to the old /status endpoint, however it improves on a few places:
- It includes a new field: "upcoming_maintenances", which list upcoming maintenances according to the status page setting "Display scheduled maintenance", similar to what you will see in your status page.
- "maintenances" field display all active maintenances, no future ones.
4. Incident updates available in all instances of the incident object
incident_activies field renamed to
In order to simplify the endpoints and to keep consistency with how naming of incident updates from the legacy name of "activities", we've renamed all instances of "activities" to "updates".
Places where this has been renamed are:
- Incident object across the API
- POST api/v2/status_pages/:subdomain/incidents/:id/updates endpoint path
6. Incident update
activity_type_id renamed to
type, now a is a string
Before, the incident update type was defined by the
activity_type_id field, this has been renamed to
type, and is not an integer anymore, instead it's a string clearly stating the type of update (“issue”, “update”, etc).
This makes creating and reading incident updates much easier from our API.