This is the API documentation for PingPong Status Pages. To utilize the API you need a PingPong account, create your free account today.
The PingPong API is organized around the REST methodology, and it uses resource-oriented URLs, and common HTTP response codes to indicate API errors. All requests are authenticated using an api-key
which can be obtained from your developer dashboard.
This API features Cross-Origin Resource Sharing (CORS) implemented in compliance with W3C spec. And that allows cross-domain communication from the browser. All responses have a wildcard same-origin which makes them completely public and accessible to everyone, including any code on any site.
Sign in to your PingPong account and go to api integration. There, you can view and copy your API token or generate a new one.
Authenticate to the API by passing the authorization token header to all requests, as shown in this example:
curl -H "Authorization: Token 5c10213ag542d5738bbeaabbe12f35ef9c89f537" \
https://api.pingpong.one/rest/v1/status
Authorization
Returns information about status page and lists of currently ongoing incidents or maintenance. Useful for notification bar widgets.
{- "project": "ACME",
- "incidents": [ ],
- "maintenance": [
- {
- "id": "k9gVLLPoNgbPA72HQKvy2b",
- "project": "ACME",
- "name": "Database migration",
- "created_at": "2020-02-03T12:15:58Z",
- "status": "In progress",
- "affected_components": [
- {
- "id": "GZ7tIAmLacSDW7sHe9Fskl",
- "project": "ACME",
- "name": "API",
- "group": {
- "id": "Qgc5CGxVJTMY8MCShAqcij",
- "project": "ACME",
- "name": "System",
- "created_at": "2020-02-07T18:35:09Z",
- "description": null
}, - "created_at": "2020-02-07T14:22:03Z",
- "status": "Maintenance mode",
- "status_color": "gray",
- "description": null,
- "showcased": true
}
], - "reported_by": "Donald Duck",
- "scheduled_for": "2020-02-10T22:00:00Z",
- "ends_at": "2020-02-10T23:00:00Z",
- "message": "Upgrading version of <b>main database</b> from version 9.0 to <strikethrough>10.0</strikethrough> 10.2."
}
]
}
[- {
- "id": "GZ7tIAmLacSDW7sHe9Fskl",
- "project": "ACME",
- "name": "API",
- "group": {
- "id": "Qgc5CGxVJTMY8MCShAqcij",
- "project": "ACME",
- "name": "System",
- "created_at": "2020-02-07T18:35:09Z",
- "description": null
}, - "created_at": "2020-02-07T14:22:03Z",
- "status": "Operational",
- "status_color": "green",
- "description": null,
- "showcased": true
}, - {
- "id": "bHH6yReKWkL92llkdk6sd7",
- "project": "ACME",
- "name": "DB",
- "group": null,
- "created_at": "2020-03-12T15:42:19Z",
- "status": "Major issues",
- "status_color": "orange",
- "description": "All databases, including read-only replicas",
- "showcased": false
}
]
Create a component.
name | string <= 50 characters Component name. |
group | uuid or null <= 255 characters Component group UUID it belongs to, or null if it doesn't belong to a group. |
description | string or null <= 255 characters Short description of the component. |
status | string or null Enum: "Unknown" "Operational" "Minor issues" "Major issues" "Critical state" "Maintenance mode" "Unavailable" Current component status. Case-insensitive. Live incidents and maintenance override this status. |
showcased | boolean Defines whether it is shown on the status page. |
{- "name": "API",
- "group": "Qgc5CGxVJTMY8MCShAqcij",
- "description": null,
- "status": "Operational",
- "showcased": true
}
{- "id": "GZ7tIAmLacSDW7sHe9Fskl",
- "project": "ACME",
- "name": "API",
- "group": {
- "id": "Qgc5CGxVJTMY8MCShAqcij",
- "project": "ACME",
- "name": "System",
- "created_at": "2020-02-07T18:35:09Z",
- "description": null
}, - "created_at": "2020-02-07T14:22:03Z",
- "status": "Operational",
- "status_color": "green",
- "description": null,
- "showcased": true
}
Returns a single component.
id required | uuid Unique ID for the component to retrieve. |
{- "id": "GZ7tIAmLacSDW7sHe9Fskl",
- "project": "ACME",
- "name": "API",
- "group": {
- "id": "Qgc5CGxVJTMY8MCShAqcij",
- "project": "ACME",
- "name": "System",
- "created_at": "2020-02-07T18:35:09Z",
- "description": null
}, - "created_at": "2020-02-07T14:22:03Z",
- "status": "Operational",
- "status_color": "green",
- "description": null,
- "showcased": true
}
Update a component.
id required | uuid Unique ID for the component to update. |
name | string <= 50 characters Component name. |
group | uuid or null <= 255 characters Component group UUID it belongs to, or null if it doesn't belong to a group. |
description | string or null <= 255 characters Short description of the component. |
status | string or null Enum: "Unknown" "Operational" "Minor issues" "Major issues" "Critical state" "Maintenance mode" "Unavailable" Current component status. Case-insensitive. Live incidents and maintenance override this status. |
showcased | boolean Defines whether it is shown on the status page. |
{- "name": "API",
- "group": "Qgc5CGxVJTMY8MCShAqcij",
- "description": null,
- "status": "Operational",
- "showcased": true
}
{- "id": "GZ7tIAmLacSDW7sHe9Fskl",
- "project": "ACME",
- "name": "API",
- "group": {
- "id": "Qgc5CGxVJTMY8MCShAqcij",
- "project": "ACME",
- "name": "System",
- "created_at": "2020-02-07T18:35:09Z",
- "description": null
}, - "created_at": "2020-02-07T14:22:03Z",
- "status": "Operational",
- "status_color": "green",
- "description": null,
- "showcased": true
}
Update the status of a component.
id required | uuid Unique ID for the component to update. |
status | string or null Enum: "Unknown" "Operational" "Minor issues" "Major issues" "Critical state" "Maintenance mode" "Unavailable" Current component status. Case-insensitive. Live incidents and maintenance override this status. |
{- "status": "Operational"
}
{- "id": "GZ7tIAmLacSDW7sHe9Fskl",
- "status": "Operational",
- "status_color": "green"
}
[- {
- "id": "Qgc5CGxVJTMY8MCShAqcij",
- "project": "ACME",
- "name": "System",
- "created_at": "2020-02-07T18:35:09Z",
- "description": null
}, - {
- "id": "UZ7tTAmLqcSDW7sHe9Fsgy",
- "project": "ACME",
- "name": "Databases",
- "created_at": "2020-02-03T15:05:49Z",
- "description": "Including read-replicas"
}
]
Create a component group.
name | string <= 50 characters Component group name. |
description | string or null <= 255 characters Short description of the component group. |
{- "name": "System",
- "description": null
}
{- "id": "Qgc5CGxVJTMY8MCShAqcij",
- "project": "ACME",
- "name": "System",
- "created_at": "2020-02-07T18:35:09Z",
- "description": null
}
Returns a single component group.
id required | uuid Unique ID for the component group to retrieve. |
{- "id": "Qgc5CGxVJTMY8MCShAqcij",
- "project": "ACME",
- "name": "System",
- "created_at": "2020-02-07T18:35:09Z",
- "description": null
}
Update a component group.
id required | uuid Unique ID for the component group to update. |
name | string <= 50 characters Component group name. |
description | string or null <= 255 characters Short description of the component group. |
{- "name": "System",
- "description": null
}
{- "id": "Qgc5CGxVJTMY8MCShAqcij",
- "project": "ACME",
- "name": "System",
- "created_at": "2020-02-07T18:35:09Z",
- "description": null
}
Returns a list of all ongoing incident events that are not resolved.
[- {
- "id": "LaPtdb2hXX3447YH7XYrt9",
- "project": "ACME",
- "title": "Database replica connection failure",
- "created_at": "2020-02-03T12:15:58Z",
- "status": "Investigating",
- "affected_components": [
- {
- "id": "GZ7tIAmLacSDW7sHe9Fskl",
- "project": "ACME",
- "name": "API",
- "group": {
- "id": "Qgc5CGxVJTMY8MCShAqcij",
- "project": "ACME",
- "name": "System",
- "created_at": "2020-02-07T18:35:09Z",
- "description": null
}, - "created_at": "2020-02-07T14:22:03Z",
- "status": "Critical state",
- "status_color": "red",
- "description": null,
- "showcased": true
}
], - "reported_by": "Donald Duck",
- "occurred_at": "2020-03-18T09:02:24Z",
- "message": "<div><b>Summary</b><br>API can not connect to the database replica.</div>",
- "updates": [ ]
}
]
[- {
- "id": "LaPtdb2hXX3447YH7XYrt9",
- "project": "ACME",
- "title": "Database replica connection failure",
- "created_at": "2020-02-03T12:15:58Z",
- "status": "Verifying",
- "affected_components": [
- {
- "id": "GZ7tIAmLacSDW7sHe9Fskl",
- "project": "ACME",
- "name": "API",
- "group": {
- "id": "Qgc5CGxVJTMY8MCShAqcij",
- "project": "ACME",
- "name": "System",
- "created_at": "2020-02-07T18:35:09Z",
- "description": null
}, - "created_at": "2020-02-07T14:22:03Z",
- "status": "Critial state",
- "status_color": "red",
- "description": null,
- "showcased": true
}
], - "reported_by": "Donald Duck",
- "occurred_at": "2020-03-18T09:02:24Z",
- "message": "<div><b>Summary</b><br>API can not connect to the database replica.</div>",
- "updates": [
- {
- "id": "LlPtdb4hXX3447YH7XYrt9",
- "created_at": "2020-03-18T09:02:39Z",
- "reported_by": "Huey",
- "status": "Investigating",
- "message": "<div>Our devs are looking into the issue.</div>"
}, - {
- "id": "GkSMzCWZfLZzam9AK4oGKi",
- "created_at": "2020-03-18T09:02:56Z",
- "reported_by": "Dewey",
- "status": "Identified",
- "message": "<div>Our devs have found the issue and researching a solution.</div>"
}, - {
- "id": "J7eS9zJpNbVrXb2FxVuUik",
- "created_at": "2020-03-18T09:03:31Z",
- "reported_by": "Louie",
- "status": "Verifying",
- "message": "<div>A fix has been deployed and our devs are verifying the solution.</div>"
}
]
}
]
Create an incident event.
title | string <= 100 characters Incident title. |
message | string <HTML> Describes what has happened in this incident. |
occurred_at | string or null <date-time> When event started in UTC. Set to null for now. |
notify_subscribers | bool Defines whether to notify subscribers. Team is always notified. |
Array of objects (Affected Component) A list of components affected by this event. |
{- "title": "Database replica connection failure",
- "message": "<b>Summary</b><br>API can not connect to the database replica.",
- "occurred_at": "2020-03-18T09:02:24Z",
- "notify_subscribers": true,
- "affected_components": [
- {
- "id": "GZ7tIAmLacSDW7sHe9Fskl",
- "status": "Critical state"
}
]
}
{- "id": "LaPtdb2hXX3447YH7XYrt9",
- "project": "ACME",
- "title": "Database replica connection failure",
- "created_at": "2020-02-03T12:15:58Z",
- "status": "In progress",
- "affected_components": [
- {
- "id": "GZ7tIAmLacSDW7sHe9Fskl",
- "project": "ACME",
- "name": "API",
- "group": {
- "id": "Qgc5CGxVJTMY8MCShAqcij",
- "project": "ACME",
- "name": "System",
- "created_at": "2020-02-07T18:35:09Z",
- "description": null
}, - "created_at": "2020-02-07T14:22:03Z",
- "status": "Critical state",
- "status_color": "red",
- "description": null,
- "showcased": true
}
], - "reported_by": "Donald Duck",
- "occurred_at": "2020-03-18T09:02:24Z",
- "message": "<div><b>Summary</b><br>API can not connect to the database replica.</div>",
- "updates": [ ]
}
Returns a single incident event.
id required | uuid Unique ID for the incident event to retrieve. |
{- "id": "LaPtdb2hXX3447YH7XYrt9",
- "project": "ACME",
- "title": "Database replica connection failure",
- "created_at": "2020-02-03T12:15:58Z",
- "status": "Verifying",
- "affected_components": [
- {
- "id": "GZ7tIAmLacSDW7sHe9Fskl",
- "project": "ACME",
- "name": "API",
- "group": {
- "id": "Qgc5CGxVJTMY8MCShAqcij",
- "project": "ACME",
- "name": "System",
- "created_at": "2020-02-07T18:35:09Z",
- "description": null
}, - "created_at": "2020-02-07T14:22:03Z",
- "status": "Critical state",
- "status_color": "red",
- "description": null,
- "showcased": true
}
], - "reported_by": "Donald Duck",
- "occurred_at": "2020-03-18T09:02:24Z",
- "message": "<div><b>Summary</b><br>API can not connect to the database replica.</div>",
- "updates": [
- {
- "id": "LlPtdb4hXX3447YH7XYrt9",
- "created_at": "2020-03-18T09:02:39Z",
- "reported_by": "Huey",
- "status": "Investigating",
- "message": "<div>Our devs are looking into the issue.</div>"
}, - {
- "id": "GkSMzCWZfLZzam9AK4oGKi",
- "created_at": "2020-03-18T09:02:56Z",
- "reported_by": "Dewey",
- "status": "Identified",
- "message": "<div>Our devs have found the issue and researching a solution.</div>"
}, - {
- "id": "J7eS9zJpNbVrXb2FxVuUik",
- "created_at": "2020-03-18T09:03:31Z",
- "reported_by": "Louie",
- "status": "Verifying",
- "message": "<div>A fix has been deployed and our devs are verifying the solution.</div>"
}
]
}
Update an incident.
id required | uuid Unique ID for the incident event. |
title | string <= 100 characters Incident title. |
message | string <HTML> Describes what has happened in this incident. |
occurred_at | string or null <date-time> When event started in UTC. Set to null for now. |
notify_subscribers | bool Defines whether to notify subscribers. Team is always notified. |
Array of objects (Affected Component) A list of components affected by this event. |
{- "title": "Database replica connection failure",
- "message": "<b>Summary</b><br>API can not connect to the database replica.",
- "occurred_at": "2020-03-18T09:02:24Z",
- "notify_subscribers": true,
- "affected_components": [
- {
- "id": "GZ7tIAmLacSDW7sHe9Fskl",
- "status": "Critical state"
}
]
}
{- "id": "LaPtdb2hXX3447YH7XYrt9",
- "project": "ACME",
- "title": "Database replica connection failure",
- "created_at": "2020-02-03T12:15:58Z",
- "status": "Verifying",
- "affected_components": [
- {
- "id": "GZ7tIAmLacSDW7sHe9Fskl",
- "project": "ACME",
- "name": "API",
- "group": {
- "id": "Qgc5CGxVJTMY8MCShAqcij",
- "project": "ACME",
- "name": "System",
- "created_at": "2020-02-07T18:35:09Z",
- "description": null
}, - "created_at": "2020-02-07T14:22:03Z",
- "status": "Critical state",
- "status_color": "red",
- "description": null,
- "showcased": true
}
], - "reported_by": "Donald Duck",
- "occurred_at": "2020-03-18T09:02:24Z",
- "message": "<div><b>Summary</b><br>API can not connect to the database replica.</div>",
- "updates": [
- {
- "id": "LlPtdb4hXX3447YH7XYrt9",
- "created_at": "2020-03-18T09:02:39Z",
- "reported_by": "Huey",
- "status": "Investigating",
- "message": "<div>Our devs are looking into the issue.</div>"
}, - {
- "id": "GkSMzCWZfLZzam9AK4oGKi",
- "created_at": "2020-03-18T09:02:56Z",
- "reported_by": "Dewey",
- "status": "Identified",
- "message": "<div>Our devs have found the issue and researching a solution.</div>"
}, - {
- "id": "J7eS9zJpNbVrXb2FxVuUik",
- "created_at": "2020-03-18T09:03:31Z",
- "reported_by": "Louie",
- "status": "Verifying",
- "message": "<div>A fix has been deployed and our devs are verifying the solution.</div>"
}
]
}
Incident updates are messages reported to users as your team works on resolving the incident.
Returns a list of all incident updates for incident events.
incident_id required | uuid Unique ID for the incident event to retrieve its updates. |
[- {
- "id": "LlPtdb4hXX3447YH7XYrt9",
- "created_at": "2020-03-18T09:02:39Z",
- "reported_by": "Huey",
- "status": "Investigating",
- "message": "<div>Our devs are looking into the issue.</div>"
}, - {
- "id": "GkSMzCWZfLZzam9AK4oGKi",
- "created_at": "2020-03-18T09:02:56Z",
- "reported_by": "Dewey",
- "status": "Identified",
- "message": "<div>Our devs have found the issue and researching a solution.</div>"
}, - {
- "id": "J7eS9zJpNbVrXb2FxVuUik",
- "created_at": "2020-03-18T09:03:31Z",
- "reported_by": "Louie",
- "status": "Verifying",
- "message": "<div>A fix has been deployed and our devs are verifying the solution.</div>"
}
]
Create an incident update.
incident_id required | uuid Unique ID for the incident event. |
status | string Enum: "Investigating" "Identified" "Verifying" "Resolved" Current event status. |
message | string <HTML> A message of what has happened in this update. |
{- "status": "Investigating",
- "message": "Our devs are looking into the issue."
}
{- "id": "LlPtdb4hXX3447YH7XYrt9",
- "created_at": "2020-03-18T09:02:39Z",
- "reported_by": "Huey",
- "status": "Investigating",
- "message": "<div>Our devs are looking into the issue.</div>"
}
Returns a single incident update.
incident_id required | uuid Unique ID for the incident event. |
update_id required | uuid Unique ID for the incident update. |
{- "id": "LlPtdb4hXX3447YH7XYrt9",
- "created_at": "2020-03-18T09:02:39Z",
- "reported_by": "Huey",
- "status": "Investigating",
- "message": "<div>Our devs are looking into the issue.</div>"
}
Update an incident update.
incident_id required | uuid Unique ID for the incident event. |
update_id required | uuid Unique ID for the incident update. |
status | string Enum: "Investigating" "Identified" "Verifying" "Resolved" Current event status. |
message | string <HTML> A message of what has happened in this update. |
{- "status": "Investigating",
- "message": "Our devs are looking into the issue."
}
{- "id": "LlPtdb4hXX3447YH7XYrt9",
- "created_at": "2020-03-18T09:02:39Z",
- "reported_by": "Huey",
- "status": "Investigating",
- "message": "<div>Our devs are looking into the issue.</div>"
}
Deletes an incident update.
incident_id required | uuid Unique ID for the incident event. |
update_id required | uuid Unique ID for the incident update. |
{- "detail": "Authentication credentials were not provided."
}
Maintenance are scheduled future planned events that might interrupt your service, which you want to communicate to your users.
[- {
- "id": "k9gVLLPoNgbPA72HQKvy2b",
- "project": "ACME",
- "name": "Database migration",
- "created_at": "2020-02-03T12:15:58Z",
- "status": "In progress",
- "affected_components": [
- {
- "id": "GZ7tIAmLacSDW7sHe9Fskl",
- "project": "ACME",
- "name": "API",
- "group": {
- "id": "Qgc5CGxVJTMY8MCShAqcij",
- "project": "ACME",
- "name": "System",
- "created_at": "2020-02-07T18:35:09Z",
- "description": null
}, - "created_at": "2020-02-07T14:22:03Z",
- "status": "Maintenance mode",
- "status_color": "gray",
- "description": null,
- "showcased": true
}
], - "reported_by": "Donald Duck",
- "scheduled_for": "2020-02-10T22:00:00Z",
- "ends_at": "2020-02-10T23:00:00Z",
- "message": "<div>Upgrading version of <b>main database</b> from version 9.0 to <strikethrough>10.0</strikethrough> 10.2.</div>"
}
]
Create an maintenance event.
title | string <= 100 characters Maintenance title. |
message | string <HTML> What will happen during the maintenance. |
scheduled_for | string <date-time> When event will occur in UTC. |
ends_at | string <date-time> When event will end in UTC. |
notify_subscribers | bool Defines whether to notify subscribers. Team is always notified. |
affected_components | Array of arrays A list of component IDs affected by this event. |
{- "title": "Database migration planned",
- "message": "MySQL replica will be moved to a different server.",
- "scheduled_for": "2020-02-10T22:00:00Z",
- "ends_at": "2020-02-10T23:00:00Z",
- "notify_subscribers": true,
- "affected_components": [
- "GZ7tIAmLacSDW7sHe9Fskl"
]
}
{- "id": "k9gVLLPoNgbPA72HQKvy2b",
- "project": "ACME",
- "name": "Database migration",
- "created_at": "2020-02-03T12:15:58Z",
- "status": "In progress",
- "affected_components": [
- {
- "id": "GZ7tIAmLacSDW7sHe9Fskl",
- "project": "ACME",
- "name": "API",
- "group": {
- "id": "Qgc5CGxVJTMY8MCShAqcij",
- "project": "ACME",
- "name": "System",
- "created_at": "2020-02-07T18:35:09Z",
- "description": null
}, - "created_at": "2020-02-07T14:22:03Z",
- "status": "Maintenance mode",
- "status_color": "gray",
- "description": null,
- "showcased": true
}
], - "reported_by": "Donald Duck",
- "scheduled_for": "2020-02-10T22:00:00Z",
- "ends_at": "2020-02-10T23:00:00Z",
- "message": "<div>Upgrading version of <b>main database</b> from version 9.0 to <strikethrough>10.0</strikethrough> 10.2.</div>"
}
Returns a single maintenance event.
id required | uuid Unique ID for the maintenance event to retrieve. |
{- "id": "k9gVLLPoNgbPA72HQKvy2b",
- "project": "ACME",
- "name": "Database migration",
- "created_at": "2020-02-03T12:15:58Z",
- "status": "In progress",
- "affected_components": [
- {
- "id": "GZ7tIAmLacSDW7sHe9Fskl",
- "project": "ACME",
- "name": "API",
- "group": {
- "id": "Qgc5CGxVJTMY8MCShAqcij",
- "project": "ACME",
- "name": "System",
- "created_at": "2020-02-07T18:35:09Z",
- "description": null
}, - "created_at": "2020-02-07T14:22:03Z",
- "status": "Maintenance mode",
- "status_color": "gray",
- "description": null,
- "showcased": true
}
], - "reported_by": "Donald Duck",
- "scheduled_for": "2020-02-10T22:00:00Z",
- "ends_at": "2020-02-10T23:00:00Z",
- "message": "<div>Upgrading version of <b>main database</b> from version 9.0 to <strikethrough>10.0</strikethrough> 10.2.</div>"
}
Update a maintenance event.
id required | uuid Unique ID for the maintenance event. |
title | string <= 100 characters Maintenance title. |
message | string <HTML> What will happen during the maintenance. |
scheduled_for | string <date-time> When event will occur in UTC. |
ends_at | string <date-time> When event will end in UTC. |
notify_subscribers | bool Defines whether to notify subscribers. Team is always notified. |
affected_components | Array of arrays A list of component IDs affected by this event. |
{- "title": "Database migration planned",
- "message": "MySQL replica will be moved to a different server.",
- "scheduled_for": "2020-02-10T22:00:00Z",
- "ends_at": "2020-02-10T23:00:00Z",
- "notify_subscribers": true,
- "affected_components": [
- "GZ7tIAmLacSDW7sHe9Fskl"
]
}
{- "id": "k9gVLLPoNgbPA72HQKvy2b",
- "project": "ACME",
- "name": "Database migration",
- "created_at": "2020-02-03T12:15:58Z",
- "status": "In progress",
- "affected_components": [
- {
- "id": "GZ7tIAmLacSDW7sHe9Fskl",
- "project": "ACME",
- "name": "API",
- "group": {
- "id": "Qgc5CGxVJTMY8MCShAqcij",
- "project": "ACME",
- "name": "System",
- "created_at": "2020-02-07T18:35:09Z",
- "description": null
}, - "created_at": "2020-02-07T14:22:03Z",
- "status": "Maintenance mode",
- "status_color": "gray",
- "description": null,
- "showcased": true
}
], - "reported_by": "Donald Duck",
- "scheduled_for": "2020-02-10T22:00:00Z",
- "ends_at": "2020-02-10T23:00:00Z",
- "message": "<div>Upgrading version of <b>main database</b> from version 9.0 to <strikethrough>10.0</strikethrough> 10.2.</div>"
}
[- {
- "id": "LPGPFfUjHpnJfMXvqnctt7",
- "project": "ACME",
- "name": "API",
- "description": null,
- "created_at": "2020-02-19T16:13:58Z",
- "component": {
- "id": "GZ7tIAmLacSDW7sHe9Fskl",
- "project": "ACME",
- "name": "API",
- "group": {
- "id": "Qgc5CGxVJTMY8MCShAqcij",
- "project": "ACME",
- "name": "System",
- "created_at": "2020-02-07T18:35:09Z",
- "description": null
}, - "created_at": "2020-02-07T14:22:03Z",
- "status": "Maintenance mode",
- "status_color": "gray",
- "description": null,
- "showcased": true
}, - "frequency": "5 minutes",
- "location": "US West",
- "showcased": "Showcase uptime"
}
]
Create a metric.
name | string <= 50 characters Metric name. |
description | string or null <= 255 characters Short description of the metric. |
created_at | string <date-time> Datetime when metric was created in UTC. |
component | uuid or null <= 255 characters Component UUID it is connected to, or null if it isn't connected. |
url | string URL to ping. |
frequency | string Enum: "minute" "2 minutes" "5 minutes" "10 minutes" "15 minutes" "30 minutes" "60 minutes" URL is pinged with this frequency. |
location | string Enum: "US West" "US East" "Brazil" "United Kingdom" "Italy" "Sweden" "South Africa" "Singapore" "Australia" "Japan" URL is pinged from this location. Case-insensitive. |
showcased | string Enum: "Don't showcase" "Showcase uptime and response time" "Showcase uptime" "Showcase response time" Defines whether it is shown on the status page. Case-insensitive. |
{- "name": "API",
- "description": null,
- "created_at": "2020-02-19T16:13:58Z",
- "component": "GZ7tIAmLacSDW7sHe9Fskl",
- "frequency": "5 minutes",
- "location": "US West",
- "showcased": "Showcase uptime"
}
{- "id": "LPGPFfUjHpnJfMXvqnctt7",
- "project": "ACME",
- "name": "API",
- "description": null,
- "created_at": "2020-02-19T16:13:58Z",
- "component": {
- "id": "GZ7tIAmLacSDW7sHe9Fskl",
- "project": "ACME",
- "name": "API",
- "group": {
- "id": "Qgc5CGxVJTMY8MCShAqcij",
- "project": "ACME",
- "name": "System",
- "created_at": "2020-02-07T18:35:09Z",
- "description": null
}, - "created_at": "2020-02-07T14:22:03Z",
- "status": "Maintenance mode",
- "status_color": "gray",
- "description": null,
- "showcased": true
}, - "frequency": "5 minutes",
- "location": "US West",
- "showcased": "Showcase uptime"
}
Returns a single metric.
id required | uuid Unique ID for the metric to retrieve. |
{- "id": "LPGPFfUjHpnJfMXvqnctt7",
- "project": "ACME",
- "name": "API",
- "description": null,
- "created_at": "2020-02-19T16:13:58Z",
- "component": {
- "id": "GZ7tIAmLacSDW7sHe9Fskl",
- "project": "ACME",
- "name": "API",
- "group": {
- "id": "Qgc5CGxVJTMY8MCShAqcij",
- "project": "ACME",
- "name": "System",
- "created_at": "2020-02-07T18:35:09Z",
- "description": null
}, - "created_at": "2020-02-07T14:22:03Z",
- "status": "Maintenance mode",
- "status_color": "gray",
- "description": null,
- "showcased": true
}, - "frequency": "5 minutes",
- "location": "US West",
- "showcased": "Showcase uptime"
}
Update a metric.
id required | uuid Unique ID for the metric to update. |
name | string <= 50 characters Metric name. |
description | string or null <= 255 characters Short description of the metric. |
created_at | string <date-time> Datetime when metric was created in UTC. |
component | uuid or null <= 255 characters Component UUID it is connected to, or null if it isn't connected. |
url | string URL to ping. |
frequency | string Enum: "minute" "2 minutes" "5 minutes" "10 minutes" "15 minutes" "30 minutes" "60 minutes" URL is pinged with this frequency. |
location | string Enum: "US West" "US East" "Brazil" "United Kingdom" "Italy" "Sweden" "South Africa" "Singapore" "Australia" "Japan" URL is pinged from this location. Case-insensitive. |
showcased | string Enum: "Don't showcase" "Showcase uptime and response time" "Showcase uptime" "Showcase response time" Defines whether it is shown on the status page. Case-insensitive. |
{- "name": "API",
- "description": null,
- "created_at": "2020-02-19T16:13:58Z",
- "component": "GZ7tIAmLacSDW7sHe9Fskl",
- "frequency": "5 minutes",
- "location": "US West",
- "showcased": "Showcase uptime"
}
{- "id": "LPGPFfUjHpnJfMXvqnctt7",
- "project": "ACME",
- "name": "API",
- "description": null,
- "created_at": "2020-02-19T16:13:58Z",
- "component": {
- "id": "GZ7tIAmLacSDW7sHe9Fskl",
- "project": "ACME",
- "name": "API",
- "group": {
- "id": "Qgc5CGxVJTMY8MCShAqcij",
- "project": "ACME",
- "name": "System",
- "created_at": "2020-02-07T18:35:09Z",
- "description": null
}, - "created_at": "2020-02-07T14:22:03Z",
- "status": "Maintenance mode",
- "status_color": "gray",
- "description": null,
- "showcased": true
}, - "frequency": "5 minutes",
- "location": "US West",
- "showcased": "Showcase uptime"
}
Add data points to custom metrics.
Please note the following before submitting data points:
Data points must be in UTC.
Data points are cast to minutes, removing the seconds.
The response data points have the casted values as they are stored.
Data points are updated if the specific minute already exists.
Data points older than 30 days are discarded.
Data object with data point values to add to custom metrics
{- "data": {
- "29epTBPdfSTBB7LAmTfADw": [
- {
- "timestamp": 1615387895,
- "value": 11.6
}, - {
- "timestamp": 1615387935,
- "value": 12.1
}
]
}
}
{- "29epTBPdfSTBB7LAmTfADw": [
- {
- "timestamp": 1615387860,
- "value": 11.6
}, - {
- "timestamp": 1615387920,
- "value": 12.1
}
]
}
[- {
- "id": "29epTBPdfSTBB7LAmTfADw",
- "project": "ACME",
- "name": "Errors",
- "description": null,
- "created_at": "2020-02-03T08:16:39Z",
- "component": {
- "id": "GZ7tIAmLacSDW7sHe9Fskl",
- "project": "ACME",
- "name": "API",
- "group": {
- "id": "Qgc5CGxVJTMY8MCShAqcij",
- "project": "ACME",
- "name": "System",
- "created_at": "2020-02-07T18:35:09Z",
- "description": null
}, - "created_at": "2020-02-07T14:22:03Z",
- "status": "Maintenance mode",
- "status_color": "gray",
- "description": null,
- "showcased": true
}, - "suffix": "per minute",
- "rollup": "Max",
- "showcased": true
}
]
Create a custom metric.
name | string <= 50 characters Custom metric name. |
description | string or null <= 255 characters Short description of the custom metric. |
created_at | string <date-time> Datetime when custom metric was created in UTC. |
component | uuid or null <= 255 characters Component UUID it is connected to, or null if it isn't connected. |
suffix | string <= 50 characters Metric unit/suffix. |
rollup | string Enum: "Mean value" "Mean value (rounded)" "Sum of all values" "Minimum value" "Maximum value" Rollup type. Case-insensitive. |
showcased | boolean Defines whether it is shown on the status page. |
{- "name": "Errors",
- "description": null,
- "created_at": "2020-02-03T08:16:39Z",
- "component": "GZ7tIAmLacSDW7sHe9Fskl",
- "suffix": "per minute",
- "rollup": "Maximum value",
- "showcased": true
}
{- "id": "29epTBPdfSTBB7LAmTfADw",
- "project": "ACME",
- "name": "Errors",
- "description": null,
- "created_at": "2020-02-03T08:16:39Z",
- "component": {
- "id": "GZ7tIAmLacSDW7sHe9Fskl",
- "project": "ACME",
- "name": "API",
- "group": {
- "id": "Qgc5CGxVJTMY8MCShAqcij",
- "project": "ACME",
- "name": "System",
- "created_at": "2020-02-07T18:35:09Z",
- "description": null
}, - "created_at": "2020-02-07T14:22:03Z",
- "status": "Maintenance mode",
- "status_color": "gray",
- "description": null,
- "showcased": true
}, - "suffix": "per minute",
- "rollup": "Maximum value",
- "showcased": true
}
Returns a single custom metric.
id required | uuid Unique ID for the custom metric to retrieve. |
{- "id": "29epTBPdfSTBB7LAmTfADw",
- "project": "ACME",
- "name": "Errors",
- "description": null,
- "created_at": "2020-02-03T08:16:39Z",
- "component": {
- "id": "GZ7tIAmLacSDW7sHe9Fskl",
- "project": "ACME",
- "name": "API",
- "group": {
- "id": "Qgc5CGxVJTMY8MCShAqcij",
- "project": "ACME",
- "name": "System",
- "created_at": "2020-02-07T18:35:09Z",
- "description": null
}, - "created_at": "2020-02-07T14:22:03Z",
- "status": "Maintenance mode",
- "status_color": "gray",
- "description": null,
- "showcased": true
}, - "suffix": "per minute",
- "rollup": "Maximum value",
- "showcased": true
}
Update a custom metric.
id required | uuid Unique ID for the custom metric to update. |
name | string <= 50 characters Custom metric name. |
description | string or null <= 255 characters Short description of the custom metric. |
created_at | string <date-time> Datetime when custom metric was created in UTC. |
component | uuid or null <= 255 characters Component UUID it is connected to, or null if it isn't connected. |
suffix | string <= 50 characters Metric unit/suffix. |
rollup | string Enum: "Mean value" "Mean value (rounded)" "Sum of all values" "Minimum value" "Maximum value" Rollup type. Case-insensitive. |
showcased | boolean Defines whether it is shown on the status page. |
{- "name": "Errors",
- "description": null,
- "created_at": "2020-02-03T08:16:39Z",
- "component": "GZ7tIAmLacSDW7sHe9Fskl",
- "suffix": "per minute",
- "rollup": "Maximum value",
- "showcased": true
}
{- "id": "29epTBPdfSTBB7LAmTfADw",
- "project": "ACME",
- "name": "Errors",
- "description": null,
- "created_at": "2020-02-03T08:16:39Z",
- "component": {
- "id": "GZ7tIAmLacSDW7sHe9Fskl",
- "project": "ACME",
- "name": "API",
- "group": {
- "id": "Qgc5CGxVJTMY8MCShAqcij",
- "project": "ACME",
- "name": "System",
- "created_at": "2020-02-07T18:35:09Z",
- "description": null
}, - "created_at": "2020-02-07T14:22:03Z",
- "status": "Maintenance mode",
- "status_color": "gray",
- "description": null,
- "showcased": true
}, - "suffix": "per minute",
- "rollup": "Maximum value",
- "showcased": true
}
status | string Enum: "All systems operational" "Some systems have issues" "All systems down" "Under maintenance" Status phrase as shown on the status page. |
status_color | string Enum: "green" "orange" "red" "gray" Human readable color name. |
{- "status": "All systems operational",
- "status_color": "green"
}
project | string Project name. |
url | string Status page URL. |
Array of objects (Incident) A list of ongoing incidents. | |
Array of objects (Maintenance) A list of maintenance currently in progress. |
{- "project": "ACME",
- "incidents": [ ],
- "maintenance": [
- {
- "id": "k9gVLLPoNgbPA72HQKvy2b",
- "project": "ACME",
- "name": "Database migration",
- "created_at": "2020-02-03T12:15:58Z",
- "status": "In progress",
- "affected_components": [
- {
- "id": "GZ7tIAmLacSDW7sHe9Fskl",
- "project": "ACME",
- "name": "API",
- "group": {
- "id": "Qgc5CGxVJTMY8MCShAqcij",
- "project": "ACME",
- "name": "System",
- "created_at": "2020-02-07T18:35:09Z",
- "description": null
}, - "created_at": "2020-02-07T14:22:03Z",
- "status": "Maintenance mode",
- "status_color": "gray",
- "description": null,
- "showcased": true
}
], - "reported_by": "Donald Duck",
- "scheduled_for": "2020-02-10T22:00:00Z",
- "ends_at": "2020-02-10T23:00:00Z",
- "message": "Upgrading version of <b>main database</b> from version 9.0 to <strikethrough>10.0</strikethrough> 10.2."
}
]
}
id | uuid <= 22 characters Unique identifier. |
project | string <= 50 characters Project name. |
name | string <= 50 characters Component name. |
group | object or null Component group it belongs to, or null if it doesn't belong to a group. |
created_at | string <date-time> Datetime when component was created in UTC. |
status | string Enum: "Unknown" "Operational" "Minor issues" "Major issues" "Critical state" "Maintenance mode" "Unavailable" Current status as shown on the status page. |
status_color | string Enum: "green" "orange" "red" Human readable color name. |
description | string or null <= 255 characters Short description of the component. |
showcased | boolean Defines whether it is shown on the status page. |
{- "id": "GZ7tIAmLacSDW7sHe9Fskl",
- "project": "ACME",
- "name": "API",
- "group": {
- "id": "Qgc5CGxVJTMY8MCShAqcij",
- "project": "ACME",
- "name": "System",
- "created_at": "2020-02-07T18:35:09Z",
- "description": null
}, - "created_at": "2020-02-07T14:22:03Z",
- "status": "Operational",
- "status_color": "green",
- "description": null,
- "showcased": true
}
id | uuid <= 22 characters Unique identifier. |
project | string <= 50 characters Project name. |
name | string <= 50 characters Group name. |
created_at | string <date-time> Datetime when group was created in UTC. |
description | string or null <= 255 characters Short description about the group. |
{- "id": "Qgc5CGxVJTMY8MCShAqcij",
- "project": "ACME",
- "name": "System",
- "created_at": "2020-02-07T18:35:09Z",
- "description": null
}
id | uuid <= 22 characters Unique identifier. |
project | string <= 50 characters Project name. |
title | string <= 100 characters Incident title. |
created_at | string <date-time> Datetime when event was created in UTC. |
status | string Enum: "In progress" "Investigating" "Identified" "Verifying" "Resolved" Current event status. |
Array of objects (Component) A list of components affected by this event. | |
reported_by | string Name of the person in your team who reported the event. |
occurred_at | string or null <date-time> When event started in UTC. |
message | string <HTML> Describes what has happened in this incident. |
Array of objects (Incident Update) A list of update messages for this event. |
{- "id": "LaPtdb2hXX3447YH7XYrt9",
- "project": "ACME",
- "title": "Database replica connection failure",
- "created_at": "2020-02-03T12:15:58Z",
- "status": "Verifying",
- "affected_components": [
- {
- "id": "GZ7tIAmLacSDW7sHe9Fskl",
- "project": "ACME",
- "name": "API",
- "group": {
- "id": "Qgc5CGxVJTMY8MCShAqcij",
- "project": "ACME",
- "name": "System",
- "created_at": "2020-02-07T18:35:09Z",
- "description": null
}, - "created_at": "2020-02-07T14:22:03Z",
- "status": "Critical state",
- "status_color": "red",
- "description": null,
- "showcased": true
}
], - "reported_by": "Donald Duck",
- "occurred_at": "2020-03-18T09:02:24Z",
- "message": "<div><b>Summary</b><br>API can not connect to the database replica.</div>",
- "updates": [
- {
- "id": "LlPtdb4hXX3447YH7XYrt9",
- "created_at": "2020-03-18T09:02:39Z",
- "reported_by": "Huey",
- "status": "Investigating",
- "message": "<div>Our devs are looking into the issue.</div>"
}, - {
- "id": "GkSMzCWZfLZzam9AK4oGKi",
- "created_at": "2020-03-18T09:02:56Z",
- "reported_by": "Dewey",
- "status": "Identified",
- "message": "<div>Our devs have found the issue and researching a solution.</div>"
}, - {
- "id": "J7eS9zJpNbVrXb2FxVuUik",
- "created_at": "2020-03-18T09:03:31Z",
- "reported_by": "Louie",
- "status": "Verifying",
- "message": "<div>A fix has been deployed and our devs are verifying the solution.</div>"
}
]
}
id | uuid <= 22 characters Unique identifier. |
created_at | string <date-time> Datetime when event was created in UTC. |
status | string Enum: "In progress" "Investigating" "Identified" "Verifying" "Resolved" Current event status. |
reported_by | string Name of the person in your team who reported the event. |
message | string <HTML> A message of what has happened in this update. |
{- "id": "LlPtdb4hXX3447YH7XYrt9",
- "created_at": "2020-03-18T09:02:39Z",
- "reported_by": "Huey",
- "status": "Investigating",
- "message": "<div>Our devs are looking into the issue.</div>"
}
id | uuid <= 22 characters Unique identifier. |
project | string <= 50 characters Project name. |
name | string <= 50 characters Maintenance name. |
created_at | string <date-time> Datetime when event was created in UTC. |
status | string Enum: "Upcoming" "In progress" "Complete" Current event status. |
Array of objects (Component) A list of components affected by this event. | |
reported_by | string Name of the person in your team who reported the event. |
scheduled_for | string <date-time> When event will occur in UTC. |
ends_at | string <date-time> When event will end in UTC. |
message | string <HTML> What will happen during the maintenance. |
{- "id": "k9gVLLPoNgbPA72HQKvy2b",
- "project": "ACME",
- "name": "Database migration",
- "created_at": "2020-02-03T12:15:58Z",
- "status": "In progress",
- "affected_components": [
- {
- "id": "GZ7tIAmLacSDW7sHe9Fskl",
- "project": "ACME",
- "name": "API",
- "group": {
- "id": "Qgc5CGxVJTMY8MCShAqcij",
- "project": "ACME",
- "name": "System",
- "created_at": "2020-02-07T18:35:09Z",
- "description": null
}, - "created_at": "2020-02-07T14:22:03Z",
- "status": "Maintenance mode",
- "status_color": "gray",
- "description": null,
- "showcased": true
}
], - "reported_by": "Donald Duck",
- "scheduled_for": "2020-02-10T22:00:00Z",
- "ends_at": "2020-02-10T23:00:00Z",
- "message": "<div>Upgrading version of <b>main database</b> from version 9.0 to <strikethrough>10.0</strikethrough> 10.2.</div>"
}
id | uuid <= 22 characters Unique identifier. |
project | string <= 50 characters Project name. |
name | string <= 50 characters Metric name. |
description | string or null <= 255 characters Short description of the metric. |
created_at | string <date-time> Datetime when metric was created in UTC. |
component | object A component connected to this metric. |
url | string URL to ping. |
frequency | string Enum: "minute" "2 minutes" "5 minutes" "10 minutes" "15 minutes" "30 minutes" "60 minutes" URL is pinged with this frequency. |
location | string Enum: "Don't showcase" "Showcase uptime and response time" "Showcase uptime" "Showcase response time" URL is pinged from this location. |
showcased | string Defines whether it is shown on the status page. |
{- "id": "LPGPFfUjHpnJfMXvqnctt7",
- "project": "ACME",
- "name": "API",
- "description": null,
- "created_at": "2020-02-19T16:13:58Z",
- "component": {
- "id": "GZ7tIAmLacSDW7sHe9Fskl",
- "project": "ACME",
- "name": "API",
- "group": {
- "id": "Qgc5CGxVJTMY8MCShAqcij",
- "project": "ACME",
- "name": "System",
- "created_at": "2020-02-07T18:35:09Z",
- "description": null
}, - "created_at": "2020-02-07T14:22:03Z",
- "status": "Maintenance mode",
- "status_color": "gray",
- "description": null,
- "showcased": true
}, - "frequency": "5 minutes",
- "location": "US West",
- "showcased": "Showcase uptime"
}
id | uuid <= 22 characters Unique identifier. |
project | string <= 50 characters Project name. |
name | string <= 50 characters Custom metric name. |
description | string or null <= 255 characters Short description of the custom metric. |
created_at | string <date-time> Datetime when custom metric was created in UTC. |
component | object A component connected to this custom metric. |
suffix | string <= 50 characters Metric unit/suffix. |
rollup | string Enum: "Mean value" "Mean value (rounded)" "Sum of all values" "Minimum value" "Maximum value" Rollup type. |
showcased | boolean Defines whether it is shown on the status page. |
{- "id": "29epTBPdfSTBB7LAmTfADw",
- "project": "ACME",
- "name": "Errors",
- "description": null,
- "created_at": "2020-02-03T08:16:39Z",
- "component": {
- "id": "GZ7tIAmLacSDW7sHe9Fskl",
- "project": "ACME",
- "name": "API",
- "group": {
- "id": "Qgc5CGxVJTMY8MCShAqcij",
- "project": "ACME",
- "name": "System",
- "created_at": "2020-02-07T18:35:09Z",
- "description": null
}, - "created_at": "2020-02-07T14:22:03Z",
- "status": "Maintenance mode",
- "status_color": "gray",
- "description": null,
- "showcased": true
}, - "suffix": "per minute",
- "rollup": "Maximum value",
- "showcased": true
}
data | object Container for custom metric data points. |
{- "data": {
- "29epTBPdfSTBB7LAmTfADw": [
- {
- "timestamp": 1617786615,
- "value": 11.6
}
]
}
}
Array of objects (Data Point) A list of data points. |
{- "29epTBPdfSTBB7LAmTfADw": [
- {
- "timestamp": 1615387895,
- "value": 11.6
}, - {
- "timestamp": 1615819080,
- "value": 12.1
}
]
}
timestamp | integer <int32> Timestamp in UTC when data point occurred. |
value | integer, float Data point value. |
{- "timestamp": 1615387895,
- "value": 11.6
}