If an incident is currently not marked as resolved, this endpoint will return it.

If an incident occurred in the last 5 days, it is returned by this endpoint.

All incidents are assigned a unique identifier, and this endpoint allows information about an incident to be retrieved on an incident-by-incident basis.

Change display information like the title or severity of an incident here. Note that once an incident state has been marked as resolved, this endpoint will cease to work.

As the state of an incident changes, this endpoint allows updates to be appended to the incident view.

This endpoint creates or updates a new key-value association in the KV table.

The KV API can be provided with an array of strings to search the values of. Any missing entries will be returned with a null value.

If you have a custom metric, it can be retrieved from this endpoint by id. By default the 60 most recent entries are returned.

Removes a metric and all associated entries.

Creates a new metric entry and associates it with the provided metric id

This endpoint is useful if you've been testing scripts that push to a custom metric, and you'd like to clear the sample entries before deploying.

This endpoint returns limited information about a service, use the specific endpoints to get a service's incident history.

This endpoint currently returns the entire incident history of a service. This may change in the future.

You can specify how far into the past this endpoint will search as a query parameter.

The status of the service will automatically be changed to that of the "worst" current incident.

All services automatically have their historic uptime calculated. This operation is expensive for services with a long history, and therefore results returned by this endpoint are cached after the first request.