Heartbeat API (Deprecated)

Please refer to Heartbeat Monitoring for preliminary information.

📘
Create an API Integration and obtain your apiKey to make requests listed below. Please make sure that the integration is not restricted to access configurations. Otherwise, the integration will only be authorized to send Send Heartbeat Requests.

Add Heartbeat Request

Add Heartbeat request is used to define heartbeats in OpsGenie. A heartbeat needs to be added, before sending heartbeat messages to OpsGenie. Add heartbeat takes the following parameters:

Mandatory Parameters

Parameter		Limit
name	Name of the heartbeat	200 chars
apiKey	API key is used for authenticating API requests

Optional Parameters

Parameter		Limit
interval	Specifies how often a heartbeat message should be expected.
intervalUnit	interval specified as minutes, hours or days
description	An optional description of the heartbeat	10000 chars
enabled	Enable/disable heartbeat monitoring

Sample Request

curl -XPOST 'https://api.opsgenie.com/v1/json/heartbeat' -d '
{
     "apiKey": "eb243592-faa2-4ba2-a551q-1afdf565c889",
     "name" : "nagios server",
     "description": "nagios server sending heartbeats once a minute",
     "interval": 5,
     "intervalUnit": "minutes",
     "enabled" : true
}'

Response:

{
    "name" : "nagios server",
    "status" : "successful",
    "code" : 200
}

Update Heartbeat Request

Update Heartbeat is used to change configuration of existing heartbeats.

Mandatory Parameters

Parameter
name	Name of the heartbeat
apiKey	API key is used for authenticating API requests

Optional Parameters

Parameter		Limit
interval	Specifies how often a heartbeat message should be expected.
intervalUnit	interval specified as minutes, hours or days
description	An optional description of the heartbeat	10000 chars
enabled	Enable/disable heartbeat monitoring

Sample Request

curl -XPOST 'https://api.opsgenie.com/v1/json/heartbeat' -d '
{
     "apiKey": "eb243592-faa2-4ba2-a551q-1afdf565c889",
     "name" : "nagios server",
     "description": "nagios server sending heartbeat failed"
}'

Response:

{
    "name" : "nagios server",
    "status" : "successful",
    "code" : 200
}

Send Heartbeat Request

Heartbeat request is used to send heartbeat from applications to OpsGenie. It takes the following parameters:

Mandatory Parameters

Parameter
apiKey	API key is used for authenticating API requests

Optional Parameters

Parameter
name	Name of the heartbeat.

Sample Request

curl -XPOST 'https://api.opsgenie.com/v1/json/heartbeat/send' -d '
{
     "apiKey": "eb243592-faa2-4ba2-a551q-1afdf565c889",
     "name" : "host1"
}'

Response:

{
     "heartbeat" : 1404816169107,
     "willExpireAt" : 1404816769107,
     "status" : "successful",
     "code" : 200
}

Delete Heartbeat Request

Delete heartbeat request is used to delete monitored heartbeat in OpsGenie. It takes the following parameters:

Mandatory Parameters

Parameter
apiKey	API key is used for authenticating API requests
name	Name of the heartbeat.

Sample Request

curl -XDELETE 'https://api.opsgenie.com/v1/json/heartbeat?apiKey=eb243592-faa2-4ba2-a551q-1afdf565c889&name=host1'

Response:

{
     "status" : "successful",
     "code" : 200
}

Enable Heartbeat Request

Enable heartbeat request is used to enable monitored heartbeat in OpsGenie. It takes the following parameters:

Mandatory Parameters

Parameter
apiKey	API key is used for authenticating API requests
name	Name of the heartbeat.

Sample Request

curl -XPOST 'https://api.opsgenie.com/v1/json/heartbeat/enable?apiKey=eb243592-faa2-4ba2-a551q-1afdf565c889&name=host1'

Response:

{
    "status" : "success",
    "code" : 200
}

Disable Heartbeat Request

📘
This is a read request. Therefore, even if the integration of the API key is configured as read-only, the request will be accepted.

Get heartbeat request is used to retrieve details of heartbeat monitors in OpsGenie. It takes the following parameters:

Mandatory Parameters

Parameter
apiKey	API key is used for authenticating API requests
name	Name of the heartbeat.

Sample Request

curl -XGET 'https://api.opsgenie.com/v1/json/heartbeat?apiKey=eb243592-faa2-4ba2-a551q-1afdf565c889&name=host1'

Response:

{
    "name" : "host1",
    "status" : "Expired",
    "description" : "sample heartbeat",
    "enabled" : true,
    "lastHeartbeat" : 1404816169107,
    "interval" : 10,
    "intervalUnit" : "hours",
    "expired" : true
}

List Heartbeats Request

📘
This is a read request. Therefore, even if the integration of the API key is configured as read-only, the request will be accepted.

List heartbeats request is used to list details of heartbeat monitors in OpsGenie. It takes the following parameters:

Mandatory Parameters

Parameter
apiKey	API key is used for authenticating API requests

Sample Requests

curl -XGET 'https://api.opsgenie.com/v1/json/heartbeat?apiKey=eb243592-faa2-4ba2-a551q-1afdf565c889'

Response:

Timestamps are Unix Epoch as milliseconds

{
    "heartbeats":[
        {
            "name" : "host1",
            "status" : "Expired",
            "description" : "sample heartbeat",
            "enabled" : true,
            "lastHeartbeat" : 1404816169107,
            "interval" : 10,
            "intervalUnit" : "hours",
            "expired" : true
        },
        {
            "name" : "db1",
            "status" : "Active",
            "description" : "",
            "enabled" : false,
            "lastHeartbeat" : 1404816169207,
            "interval" : 20,
            "intervalUnit" : "minutes",
            "expired" : false
        }
    ]
}