Get started with Opsgenie as a user
Learn how to configure your profile, get notifications from Opsgenie and view on-call schedules.
Beginning from April 2, 2018, Heartbeat API v1 will not be accessible and this document is to help you migrate to our new Heartbeat API.
Base URL
New Heartbeat base URL is https://api.opsgenie.com/v2/heartbeats
apiKey usage
apiKey is now removed from all payloads. In new requests, apiKey can be provided in Authorization header as described in following document:
Payload fields "interval", "intervalUnit" and "enabled" are now mandatory fields. "description" fields remains same as optional.
Content-Type header should be provided as “application/json”.
For changes in response, see new Heartbeat API document.
“name” field in previous version is now provided as URL path variable, see new Heartbeat API document for example request url and response.
HTTP method changed from POST to PATCH for update requests.
Content-Type header should be provided as “application/json”.
“name” field in previous version is now provided as URL path variable, see new Heartbeat API document for example request url and response.
“name” field in previous version is now provided as URL path variable, see new Heartbeat API document for example request url and response.
HTTP methods used in these requests now support PUT and PATCH in addition to POST.
“name” field in previous version is now provided as URL path variable, see new Heartbeat API document for example request urls and responses.
Send Heartbeat request in previous version is now called Ping Heartbeat. This change also applied to URL for this request.
HTTP methods used in this request now support GET, PUT and PATCH in addition to POST.
This request is processed asynchronously, thus, in case of a problem, customer should check the logs manually.
“name” field in previous version is now provided as URL path variable, see new Heartbeat API document for example request url and response.
List heartbeat request is not supported in Heartbeat API v2.
Was this helpful?