Alert API (Deprecated)

📘

Create an API Integration and obtain your apiKey to make requests listed below.

Create Alert Request

Create alert request is used to create alerts in OpsGenie. It takes the following parameters:

Mandatory Parameters

ParameterLimit
apiKeyAPI key is used for authenticating API requests
messageAlert text limited to 130 characters130 chars

Optional Parameters

ParameterLimit
teamsList of team names which will be responsible for the alert. Team escalation policies are run to calculate which users will receive notifications. Teams which are exceeding the limit are ignored.50 teams
aliasUsed for Alert De-Duplication. A user defined identifier for the alert and there can be only one alert with open status with the same alias. Provides ability to assign a known id and later use this id to perform additional actions such as log, close, attach for the same alert.512 chars
descriptionThis field can be used to provide a detailed description of the alert, anything that may not have fit in the Message field.15000 chars
recipientsOptional user, group, schedule or escalation names to calculate which users will receive the notifications of the alert. Recipients which are exceeding the limit are ignored.50 recipients
actionsA comma separated list of actions that can be executed. Custom actions can be defined to enable users to execute actions for each alert. If Webhook Integration exists, webhook URL will be called when action is executed. Also if Marid Integration exists, actions will be posted to Marid. Actions will be posted to all existing bi-directional integrations too. Actions which are exceeding the number limit are ignored. Action names which are longer than length limit are shortened.10 actions, 50 chars each
sourceField to specify source of alert. By default, it will be assigned to IP address of incoming request512 chars
tagsA comma separated list of labels attached to the alert. You can overwrite Quiet Hours setting for urgent alerts by adding OverwriteQuietHours tag. Tags which are exceeding the number limit are ignored. Tag names which are longer than length limit are shortened.20 tags, 50 chars each
detailsSet of user defined properties. This will be specified as a nested JSON map such as: "details" : {"prop1":"prop1Value", "prop2":"prop2Value"}8000 chars
entityThe entity the alert is related to.512 chars
userDefault owner of the execution. If user is not specified, the system becomes owner of the execution.100 chars
noteAdditional alert note

Sample Request:

curl -XPOST 'https://api.opsgenie.com/v1/json/alert' -d '
{
     "apiKey": "eb243592-faa2-4ba2-a551q-1afdf565c889",
     "message" : "WebServer3 is down",
     "teams" : ["operations", "developers"]
}'

Response:

{
    "message" : "alert created",
    "alertId" : "d85b4c10-ca86-45f3-94a0-0685de932a86",
    "status" : "successful",
    "code" : 200
}

Sample Response When Alias is Given and Count Increased:

{
    "message" : "alert updated",
    "alertId" : "b962fe76-bdb8-4d33-ba0b-91e9c602a8fb",
    "status" : "successful",
    "code" : 201
}

Close Alert Request

Close alert request is used to close open alerts in OpsGenie. It takes the following parameters:

Mandatory Parameters

Parameter
apiKeyAPI key is used for authenticating API requests.
idID of the alert that will be closed.
aliasAlias of the alert that will be closed.
tinyIdshort ID assigned to the alert. All requests supports tinyId but using this field is not recommended because it rolls.

🚧

One of id, alias or tinyId parameters should be specified with close alert request. Alias option can only be used for open alerts

Optional Parameters

Parameter
userDefault owner of the execution. If user is not specified, the system becomes owner of the execution.
noteAdditional alert note.
sourceUser defined field to specify source of close action.

Sample Request

curl -XPOST 'https://api.opsgenie.com/v1/json/alert/close' -d '
{
      "apiKey": "eb243592-faa2-4ba2-a551q-1afdf565c889",
      "id": "ac463592-dbd2-4ca3-a651d-48fhf5j5c871"
}'

Response

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

Delete Alert Request

Delete alert request is used to delete closed alerts in OpsGenie. It takes the following parameters:

Mandatory Parameters

apiKeyAPI key is used for authenticating API requests
idID of the alert that will be deleted.
aliasAlias of the alert will be deleted.
tinyIdshort ID assigned to the alert. All requests supports tinyId but using this field is not recommended because it rolls.

🚧

One of id, alias or tinyId parameters should be specified with delete alert request. Alias option can only be used for open alerts

Optional Parameters

Parameter
userDefault owner of the execution. If user is not specified, the system becomes owner of the execution.
sourceUser defined field to specify source of delete action.

Sample Request

curl -XDELETE 'https://api.opsgenie.com/v1/json/alert?apiKey=eb243592-faa2-4ba2-a551q-1afdf565c889&id=ac463592-dbd2-4ca3-a651d-48fhf5j5c871'

Response:

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

Get Alert Request

Get alert request is used to search and retrieve alerts in OpsGenie. It takes the following parameters:

Mandatory Parameters

Parameter
apiKeyAPI key is used for authenticating API requests.
idID of the alert to be retrieved.
aliasAlias of the alert to be retrieved. Using alias will only retrieve an open alert with that alias if it exists.
tinyIdshort ID assigned to the alert. All requests supports tinyId but using this field is not recommended because it rolls.

🚧

One of id, alias or tinyId parameters should be specified with get alert request. Alias option can only be used for open alerts

Sample request to retrieve a single alert

curl -XGET 'https://api.opsgenie.com/v1/json/alert?apiKey=e3343592-faa2-4ba2-a551q-1afdf565c889&alias=host_down'
curl -XGET 'https://api.opsgenie.com/v1/json/alert?apiKey=e3343592-faa2-4ba2-a551q-1afdf565c889&id=ac463592-dbd2-4ca3-a651d-48fhf5j5c871'
curl -XGET 'https://api.opsgenie.com/v1/json/alert?apiKey=e3343592-faa2-4ba2-a551q-1afdf565c889&tinyId=324'

Response:

Timestamps are Unix Epoch as:

  • updatedAt: in nanoseconds
  • createdAt: in nanoseconds
  • ackTime : in milliseconds
  • closeTime : in milliseconds
{
    "tags": [ ],
    "count": 1,
    "status": "closed",
    "teams":["operations", "developers"]
    "recipients": [
        "[email protected]"
    ],
    "tinyId": "324",
    "alias": "host_down",
    "entity": ""
    "id": "ac463592-dbd2-4ca3-a333d-48fhf5j5c871",
    "updatedAt": 1349698149317,
    "message": "WebServer3 is down",
    "details": {
        "ip": "192.168.1.87"
    },
    "source": "[email protected]",
    "description": "WebServer3 is down due to failure in WAN-1 connection.",
    "createdAt": 1349698149317,
    "isSeen":true,
    "acknowledged":true,
    "snoozed":false,
    "owner":"[email protected]",
    "actions": [ ],
    "systemData": {
        "integrationType": "API",
        "integrationId": "95225ed3-03fb-4cdd-a035-44052d6f4496",
        "integrationName": "API",
        "ackTime":18171,
        "acknowledgedBy":"[email protected]",
        "closeTime":24737,
        "closedBy":"[email protected]"
    }
}

List Alert Request

📘

Alert list & count api is async, changes to alerts are available to list requests at most within 2 seconds.
Async behaviour does not create pagination problems. Alert create, ack, close, get actions are real time.

List alerts request is used to list alerts in OpsGenie. It takes the following parameters:

Mandatory Parameters

Parameter
apiKeyAPI key is used for authenticating API requests

Optional Parameters

Parameter
createdAfterUnix timestamp value which is converted to nano second. Request will return all alerts which are created after specified time.
createdBeforeUnix timestamp value which is converted to nano second. Request will return all alerts which are created after specified time.
updatedAfterUnix timestamp value which is converted to nano second. Request will return all alerts which are created after specified time.
updatedBeforeUnix timestamp value which is converted to nano second. Request will return all alerts which are created after specified time.
limitPage size. Default is 20. Max value for this parameter is 100.
statusUsed to query alerts with specified status. May take one of open, acked, unacked, seen, notseen, closed.
sortBycreatedAt, updatedAt, default is createdAt
orderasc/desc, default: desc
tagsA comma separated list of labels attached to the alert such as "tag1, tag2"
tagsOperatortags are combined with tagsOperator like "tag1 and tag2" when filtered. Accepted values: and/or, default: and.
teamsA comma separated list of teams that an alert belongs to such as "ops_team, business_team". One or more teams' alerts can be filtered via this parameter. If multiple teams are specified, alerts that belong to all given teams are filtered. The list can consist of team ids and team names.

Sample requests to retrieve list of alerts

retrieve the last 20 alerts (20 is the default for limit, 100 is the max for limit)

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

retrieve the last 10 open alerts

curl -XGET 'https://api.opsgenie.com/v1/json/alert?apiKey=eb243592-faa2-4ba2-a551q-1afdf565c889&status=open&limit=10'

retrieve alerts created after this time

curl -XGET 'https://api.opsgenie.com/v1/json/alert?apiKey=eb243592-faa2-4ba2-a551q-1afdf565c889&createdAfter=1351634560000000&limit=20'

retrive alerts with paging
This request retrieves oldest 5 alert by ascending order. By using the createdAt value of the 5th alert, we will make the second request.

curl -XGET 'https://api.opsgenie.com/v1/json/alert?apiKey=39d50168-24b3-4355-b285-b91060823dee&order=asc&limit=5'

Let's say "createdAt" value of the 5th alert we retrieved above is "1405953557284001300". To get 6th to 10th alerts, we should add this value to our request to retrieve 5 alerts created after that alert.

curl -XGET 'https://api.opsgenie.com/v1/json/alert?apiKey=39d50168-24b3-4355-b285-b91060823dee&order=asc&limit=5&createdAfter=1405953557284001300'

To continue polling, you can use the second request by changing createdAfter value according to the alerts you retrieved.

retrieve critical alerts that have not been acknowledged

curl -XGET 'https://api.opsgenie.com/v1/json/alert?apiKey=eb243592-faa2-4ba2-a551q-1afdf565c889&status=unacked&tags=critical'

Response:

Timestamps are Unix Epoch as nanoseconds

{
    "alerts":[
        {
             "id" : "ac463592-dbd2-4ca3-a651d-48fhf5j5c871",
             "count" : 1
             "alias" : "host_down",
             "message" : "Host 192.168.1.1 is down",
             "status" : "open",
             "isSeen" : false,
             "acknowledged" : false,
             "snoozed" : false,
             "createdAt" : "1351634560000000",
             "updatedAt" : "1351634560000000",
             "tinyId" : "111",
             "tags" : ["critical"],
             "owner" : "[email protected]",
             "teams": ["ops_team", "business_team"]
        },
        {
             "id" : "cf463592-emt2-4ca3-a651d-56hhf5j5c132",
             "count" : 1
             "alias" : "app_down",
             "message" : "Web server Web_Server1 is down",
             "status" : "closed",
             "isSeen" : true,
             "acknowledged" : false,
             "snoozed" : false,
             "createdAt" : "1351634560000000",
             "updatedAt" : "1351634560000000",
             "tinyId" : "66",
             "tags" : ["critical"],
             "owner" : "",
             "teams": ["ops_team"]
        }
    ]
}

Count Alerts Request

Count alerts request is used to counts alerts in OpsGenie. It takes the following parameters:

Mandatory Parameters

Parameter
apiKeyAPI key is used for authenticating API requests.

Optional Parameters

createdAfterUnix timestamp value which is converted to nano second. Request will return all alerts which are created after specified time.
createdBeforeUnix timestamp value which is converted to nano second. Request will return all alerts which are created after specified time.
updatedAfterUnix timestamp value which is converted to nano second. Request will return all alerts which are created after specified time.
updatedBeforeUnix timestamp value which is converted to nano second. Request will return all alerts which are created after specified time.
limitFor performance reasons, the desired result is to limit that count. Max: 100000, default: 100000
statusUsed to query alerts with specified status. May take one of open, acked, unacked, seen, notseen, closed
tagsA comma separated list of labels attached to the alert such as "tag1, tag2"
tagsOperatortags are combined with tagsOperator like "tag1 and tag2" when filtered. Accepted values: and/or, default: and.

Sample requests to retrieve count of alerts

Count all of the alerts

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

Count the open alerts

curl -XGET 'https://api.opsgenie.com/v1/json/alert/count?apiKey=eb243592-faa2-4ba2-a551q-1afdf565c889&status=open'

Count the open alerts

curl -XGET 'https://api.opsgenie.com/v1/json/alert/count?apiKey=eb243592-faa2-4ba2-a551q-1afdf565c889&status=open'

Count alerts created after a specific time

curl -XGET 'https://api.opsgenie.com/v1/json/alert/count?apiKey=eb243592-faa2-4ba2-a551q-1afdf565c889&createdAfter=1351634560000000'

Count critical alerts that have not been acknowledged

curl -XGET 'https://api.opsgenie.com/v1/json/alert/count?apiKey=eb243592-faa2-4ba2-a551q-1afdf565c889&status=unacked&tags=critical'

Response:

{
    "count" : 2
}

List Alert Notes Request

List alert notes request is used to retrieve alert notes in OpsGenie. It takes the following parameters:

Mandatory Parameters

Parameter
apiKeyAPI key is used for authenticating API requests
idID of the alert to be retrieved
aliasAlias of alert to be retrieved
tinyIdshort ID assigned to the alert. All requests supports tinyId but using this field is not recommended because it rolls.

🚧

One of id, alias or tinyId parameters should be specified with list alert notes request. Alias option can only be used for open alerts.

Optional Parameters

limitPage size. Default is 100.
orderasc/desc, default: desc
lastKeyKey which will be used in pagination

Sample request to retrieve a single alert

curl -XGET 'https://api.opsgenie.com/v1/json/alert/note?apiKey=eb243592-faa2-4ba2-a551q-1afdf565c889&alias=host_down'
curl -XGET 'https://api.opsgenie.com/v1/json/alert/note?apiKey=eb243592-faa2-4ba2-a551q-1afdf565c889&id=ac463592-dbd2-4ca3-a651d-48fhf5j5c871'

Response:

Timestamps are Unix Epoch as nanoseconds

{
    "lastKey": "13099992234_1309999223432245566",
    "notes": [
        {
            "note": "comment message",
            "owner":"[email protected]",
            "createdAt":13099992234
        }
    ]
}

List Alert Logs Request

List alert logs request is used to retrieve alert logs in OpsGenie. It takes the following parameters:

Mandatory Parameters

Parameter
apiKeyAPI key is used for authenticating API requests
idID of the alert to be retrieved
aliasAlias of alert to be retrieved
tinyIdshort ID assigned to the alert. All requests supports tinyId but using this field is not recommended because it rolls.

🚧

One of id, alias or tinyId parameters should be specified with list alert logs request. Alias option can only be used for open alerts.

Optional Parameters

Parameter
limitPage size. Default is 100
orderasc/desc, default: desc
lastKeyKey which will be used in pagination.

Sample request to retrieve alert logs.

curl -XGET 'https://api.opsgenie.com/v1/json/alert/log?apiKey=eb243592-faa2-4ba2-a551q-1afdf565c889&alias=host_down'
curl -XGET 'https://api.opsgenie.com/v1/json/alert/log?apiKey=eb243592-faa2-4ba2-a551q-1afdf565c889&id=ac463592-dbd2-4ca3-a651d-48fhf5j5c871'

Response

Timestamps are Unix Epoch as nanoseconds

{
    "lastKey": "13099992234_1309999223432245566",
    "logs": [
        {
            "log": "log message",
            "logType":"comment",
            "owner":"[email protected]",
            "createdAt":13099992234
        }
    ]
}

List Alert Recipients Request

List alert recipients request is used to retrieve alert recipients in OpsGenie. It takes the following parameters:

Mandatory Parameters

Parameter
apiKeyAPI key is used for authenticating API requests
idID of the alert to be retrieved
aliasAlias of alert to be retrieved
tinyIdshort ID assigned to the alert. All requests supports tinyId but using this field is not recommended because it rolls.

🚧

One of id, alias or tinyId parameters should be specified with list alert recipients request. Alias option can only be used for open alerts.

Sample request to retrieve a single alert

curl -XGET 'https://api.opsgenie.com/v1/json/alert/recipient?apiKey=eb243592-faa2-4ba2-a551q-1afdf565c889&alias=host_down'
curl -XGET 'https://api.opsgenie.com/v1/json/alert/recipient?apiKey=eb243592-faa2-4ba2-a551q-1afdf565c889&id=ac463592-dbd2-4ca3-a651d-48fhf5j5c871'

Response:

{
   "users": [
        {"username": "[email protected]", "state":"pending", "method":"sms", "stateChangedAt":13999878445}
   ],
   "groups": {
        "group1":[
               {"username": "[email protected]", "state":"sent", "method":"email", "stateChangedAt":13997878445}
        ]
   }
}

Acknowledge Request

Acknowledge request is used to acknowledge alerts in OpsGenie. It takes the following parameters:

Mandatory Parameters

Parameter
apiKeyAPI key is used for authenticating API requests
idID of the alert that will be acknowledged.
aliasAlias of the alert that will be acknowledged.
tinyIshort ID assigned to the alert. All requests supports tinyId but using this field is not recommended because it rolls.

🚧

One of id, alias or tinyId parameters should be specified with acknowledge alert request.

Optional Parameters

Parameter
userDefault owner of the execution. If user is not specified, the system becomes owner of the execution.
noteAdditional alert note
sourceUser defined field to specify source of acknowledge action.

Sample Request

curl -XPOST 'https://api.opsgenie.com/v1/json/alert/acknowledge' -d '
{
      "apiKey": "eb243592-faa2-4ba2-a551q-1afdf565c889",
      "id": "ac463592-dbd2-4ca3-a651d-48fhf5j5c871"
}'

Response

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

UnAcknowledge Request

UnAcknowledge request is used to revert back the alert state to un-acknowledged. It takes the following parameters:

Mandatory Parameters

Parameter
apiKeyAPI key is used for authenticating API requests
idID of the alert that will be un-acknowledged.
aliasAlias of the alert that will be un-acknowledged.
tinyIdShort ID assigned to the alert. All requests supports tinyId but using this field is not recommended because it rolls.

🚧

One of id, alias or tinyId parameters should be specified with un-acknowledge alert request.

Optional Parameter

Parameter
userDefault owner of the execution. If user is not specified, the system becomes owner of the execution.
noteAdditional alert note.
sourceUser defined field to specify source of unacknowledge action.

Sample Request

curl -XPOST 'https://api.opsgenie.com/v1/json/alert/unacknowledge' -d '
{
      "apiKey": "eb243592-faa2-4ba2-a551q-1afdf565c889",
      "id": "ac463592-dbd2-4ca3-a651d-48fhf5j5c871"
}'

Response:

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

Snooze Request

Snooze request is used to snooze alerts in OpsGenie. It takes the following parameters:

Mandatory Parameters

Parameter
apiKeyAPI key is used for authenticating API requests.
idID of the alert that will be snoozed.
aliasAlias of the alert that will be snoozed.
tinyIdshort ID assigned to the alert. All requests supports tinyId but using this field is not recommended because it rolls.
endDateThe date and time snooze will end.

🚧

One of id, alias or tinyId parameters should be specified with snooze alert request. Alias option can only be used for open alerts.

Optional Parameters

Parameter
userDefault owner of the execution. If user is not specified, the system becomes owner of the execution.
noteAdditional alert note.
sourceUser defined field to specify source of snooze action.
timezoneTimezone of endDate parameter. Please look at Supported Timezone IDs for available timezones. Defaults to Root Timezone, explained in Time Constraints and Timezones document.

Sample Request

curl -XPOST 'https://api.opsgenie.com/v1/json/alert/snooze' -d '
    {
          "apiKey": "eb243592-faa2-4ba2-a551q-1afdf565c889",
          "id": "ac463592-dbd2-4ca3-a651d-48fhf5j5c871",
          "endDate": "2016-01-28 08:00"
    }'

Response:

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

Renotify Request

Renotify request is used to renotify recipients about specified alert in OpsGenie. It takes the following parameters:

Mandatory Parameters

Parameter
apiKeyAPI key is used for authenticating API requests.
idID of the alert that will be acknowledged.
aliasAlias of the alert that will be acknowledged.
tinyIdshort ID assigned to the alert. All requests supports tinyId but using this field is not recommended because it rolls.

🚧

One of id, alias or tinyId parameters should be specified with renotify alert request. Alias option can only be used for open alerts.

Optional Parameters

recipientsThe user names of individual users or groups. If not specified alert recipients will be renotified.
userDefault owner of the execution. If user is not specified, owner of the alert will be the system.
noteAdditional alert note
sourceUser defined field to specify source of renotify action.

Sample Request

curl -XPOST 'https://api.opsgenie.com/v1/json/alert/renotify' -d '
{
      "apiKey": "eb243592-faa2-4ba2-a551q-1afdf565c889",
      "id": "ac463592-dbd2-4ca3-a651d-48fhf5j5c871",
      "recipients": "[email protected], group1"
}'

Response

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

Take Ownership Request

Take ownership request is used to take the ownership of the alerts in OpsGenie. It takes the following parameters:

Mandatory Parameters

Parameter
apiKeyAPI key is used for authenticating API requests
idID of the alert whose ownership will be taken.
aliasAlias of the alert whose ownership will be taken.
tinyIdshort ID assigned to the alert. All requests supports tinyId but using this field is not recommended because it rolls.

🚧

One of id, alias or tinyId parameters should be specified with take ownership request. Alias option can only be used for open alerts.

Optional Parameters

Parameter
userDefault owner of the execution. If user is not specified, the system becomes owner of the execution.
noteAdditional alert note
sourceUser defined field to specify source of takeownership action.

Sample Request

curl -XPOST 'https://api.opsgenie.com/v1/json/alert/takeOwnership' -d '
{
      "apiKey": "eb243592-faa2-4ba2-a551q-1afdf565c889",
      "id": "ac463592-dbd2-4ca3-a651d-48fhf5j5c871"
}'

Response

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

Assign Request

Assign request is used to assign the ownership of the alerts in OpsGenie. It takes the following parameters:

Mandatory Parameters

Parameter
apiKeyAPI key is used for authenticating API requests
idID of the alert that will be assigned.
aliasAlias of the alert that will be assigned.
tinyIdshort ID assigned to the alert. All requests supports tinyId but using this field is not recommended because it rolls.
ownerThe user who will be the owner of the alert after the execution.

🚧

One of id, alias or tinyId parameters should be specified with assign alert request. Alias option can only be used for open alerts.

Optional Parameters

Parameter
userDefault owner of the execution. If user is not specified, the system becomes owner of the execution.
noteAdditional alert note
sourceUser defined field to specify source of assign action.

Sample Request

curl -XPOST 'https://api.opsgenie.com/v1/json/alert/assign' -d '
{
      "apiKey": "eb243592-faa2-4ba2-a551q-1afdf565c889",
      "id": "ac463592-dbd2-4ca3-a651d-48fhf5j5c871",
      "owner":"[email protected]"
}'

Response

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

Add Team Request

Add team request is used to add new teams to alerts in OpsGenie. It takes the following parameters:

Mandatory Parameters

Parameter
apiKeyAPI key is used for authenticating API requests
idID of the alert that the new recipient will be added.
aliasAlias of the alert that the new recipient will be added.
tinyIdshort ID assigned to the alert. All requests support tinyId but using this field is not recommended because it rolls.
teamThe new team that will be added.

🚧

One of id, alias or tinyId parameters should be specified with add team request. Alias option can only be used for open alerts.

Optional Parameters

Parameter
userDefault owner of the execution. If the user is not specified, the system becomes the owner of the execution.
noteAdditional alert note
sourceUser defined the field to specify the source of add team action.

Sample Request

curl -XPOST 'https://api.opsgenie.com/v1/json/alert/team' -d '
{
      "apiKey": "eb243592-faa2-4ba2-a551q-1afdf565c889",
      "id": "ac463592-dbd2-4ca3-a651d-48fhf5j5c871",
      "team":"operations"
}'

Response

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

Add Recipient Request

Add recipient request is used to add new recipients(user or group) to alerts in OpsGenie. It takes the following parameters:

Mandatory Parameters

Parameter
apiKeyAPI key is used for authenticating API requests
idID of the alert that the new recipient will be added.
aliasAlias of the alert that the new recipient will be added.
tinyIdshort ID assigned to the alert. All requests support tinyId but using this field is not recommended because it rolls.
recipientThe new recipient that will be added.

🚧

One of id, alias or tinyId parameters should be specified with add recipient request. Alias option can only be used for open alerts

Optional Parameters

Parameter
userDefault owner of the execution. If user is not specified, the system becomes owner of the execution.
noteAdditional alert note
sourceUser defined field to specify source of add recipient action.

Sample Request

curl -XPOST 'https://api.opsgenie.com/v1/json/alert/recipient' -d '
{
      "apiKey": "eb243592-faa2-4ba2-a551q-1afdf565c889",
      "id": "ac463592-dbd2-4ca3-a651d-48fhf5j5c871",
      "recipient":"[email protected]"
}'

Response

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

Add Note Request

Add note request is used to add notes to alerts in OpsGenie. It takes the following parameters:

Mandatory Parameters

Parameter
apiKeyAPI key is used for authenticating API requests
idID of the alert that note will be added.
aliasAlias of the alert that note will be added.
tinyIdshort ID assigned to the alert. All requests supports tinyId but using this field is not recommended because it rolls.
noteNote text. Limit is 25000 characters

🚧

One of id, alias or tinyId parameters should be specified with add note request. Alias option can only be used for open alerts

Optional Parameters

Parameter
userDefault owner of the execution. If user is not specified, the system becomes owner of the execution.
sourceUser defined field to specify source of add note action.

Sample Request

curl -XPOST 'https://api.opsgenie.com/v1/json/alert/note' -d '
{
     "apiKey": "eb243592-faa2-4ba2-a551q-1afdf565c889",
     "id": "ac463592-dbd2-4ca3-a651d-48fhf5j5c871",
     "note": "custom note"
}'

Response

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

Add Tags Request

Add tags request is used to add tags to alerts in OpsGenie. It takes the following parameters:

Mandatory Parameters

Parameter
apiKeyAPI key is used for authenticating API requests
idID of the alert that tags will be added.
aliasAlias of the alert that tags will be added.
tinyIdshort ID assigned to the alert. All requests support tinyId but using this field is not recommended because it rolls.
tagsComma separated list of tags that will be added.

🚧

One of id or alias parameters should be specified with add tags request. Alias option can only be used for open alerts

Optional Parameters

userDefault owner of the execution. If user is not specified, the system becomes owner of the execution.
sourceUser defined field to specify source of add tags action.
noteAdditional alert note

Sample Request

curl -XPOST 'https://api.opsgenie.com/v1/json/alert/tags' -d '
{
     "apiKey": "eb243592-faa2-4ba2-a551q-1afdf565c889",
     "id": "ac463592-dbd2-4ca3-a651d-48fhf5j5c871",
     "tags": "emergency, delay"
}'

Response

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

Remove Tags

Remove tags request is used to remove tags from alerts in OpsGenie. It takes the following parameters:

Mandatory Parameters

Parameter
apiKeyAPI key is used for authenticating API requests
idID of the alert that tags will be removed from.
aliasAlias of the alert that tags will be removed from.
tinyIdshort ID assigned to the alert. All requests supports tinyId but using this field is not recommended because it rolls.
tagsComma separated list of tags that will be removed from.

🚧

One of id, alias or tinyId parameters should be specified with remove tags request. Alias option can only be used for open alerts

Optional Parameters

Parameter
userDefault owner of the execution. If user is not specified, the system becomes owner of the execution.
sourceUser defined field to specify source of remove tags action.
noteAdditional alert note

Sample Request

curl -XDELETE 'https://api.opsgenie.com/v1/json/alert/tags?apiKey=eb243592-faa2-4ba2-a551q-1afdf565c889&id=ac463592-dbd2-4ca3-a651d-48fhf5j5c871&tags=emergency,delay'

Response

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

Add Details Request

Add details request is used to add properties to alert details in OpsGenie. If you send an existing alert property's key, it overwrites the existing one. It takes the following parameters:

Mandatory Parameters

Parameter
apiKeyAPI key is used for authenticating API requests
idID of the alert that details will be added.
aliasAlias of the alert that details will be added.
tinyIdshort id assigned to the alert. All requests support tinyId but using this field is not recommended because it rolls.
detailsSet of properties to be added to alert details. This will be specified as a nested JSON map such as: "details" : {"prop1":"prop1Value", "prop2":"prop2Value"}.

🚧

One of id, alias or tinyId parameters should be specified with add details request. Alias option can only be used for open alerts

Optional Parameters

Parameter
userDefault owner of the execution. If user is not specified, the system becomes owner of the execution.
sourceUser defined field to specify source of add details action.
noteAdditional alert note

Sample Request

curl -XPOST 'https://api.opsgenie.com/v1/json/alert/details' -d '
{
     "apiKey": "eb243592-faa2-4ba2-a551q-1afdf565c889",
     "id": "ac463592-dbd2-4ca3-a651d-48fhf5j5c871",
     "details": {"prop1" : "val1", "prop2" : "val2"}
}'

Response

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

Remove Details Request

Remove details request is used to remove properties from alert details in OpsGenie. It takes the following parameters:

Mandatory Parameters

Parameter
apiKeyAPI key is used for authenticating API requests
idID of the alert that details properties will be removed from.
aliasAlias of the alert that details properties will be removed from.
tinyIdshort ID assigned to the alert. All requests support tinyId but using this field is not recommended because it rolls.
keysComma separated list of keys of alert details properties.

🚧

One of id, alias or tinyId parameters should be specified with remove details request. Alias option can only be used for open alerts

Optional Parameters

Parameter
userDefault owner of the execution. If user is not specified, the system becomes owner of the execution.
sourceUser defined field to specify source of remove details action.
noteAdditional alert note

Sample Request

curl -XDELETE 'https://api.opsgenie.com/v1/json/alert/details?apiKey=eb243592-faa2-4ba2-a551q-1afdf565c889&id=ac463592-dbd2-4ca3-a651d-48fhf5j5c871&keys=prop1,prop2'

Response

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

Execute Action Request

Execute action request is used to execute predefined actions on alerts in OpsGenie. It takes the following parameters:

Mandatory Parameters

Parameter
apiKeyAPI key is used for authenticating API requests
idID of the alert that action will be executed for.
aliasAlias of the alert that action will be executed for.
tinyIdshort ID assigned to the alert. All requests supports tinyId but using this field is not recommended because it rolls.
actionAction to execute

🚧

One of id, alias or tinyId parameters should be specified with execute action request. Alias option can only be used for open alerts

Optional Parameters

Parameter
userDefault owner of the execution. If user is not specified, the system becomes owner of the execution.
sourceUser defined field to specify source of action execution.
noteAdditional alert note

Sample Request

curl -XPOST 'https://api.opsgenie.com/v1/json/alert/executeAction' -d '
{
     "apiKey": "eb243592-faa2-4ba2-a551q-1afdf565c889",
     "id": "ac463592-dbd2-4ca3-a651d-48fhf5j5c871",
     "action": "acknowledge"
}'

Response

curl -XPOST 'https://api.opsgenie.com/v1/json/alert/executeAction' -d '
{
     "apiKey": "eb243592-faa2-4ba2-a551q-1afdf565c889",
     "id": "ac463592-dbd2-4ca3-a651d-48fhf5j5c871",
     "action": "acknowledge"
}'

Attach File Request

Attach file request is used to attach files to alerts in OpsGenie. It should be sent as multipart HTTP request. It takes the following parameters:

Mandatory Parameters

Parameter
apiKeyAPI key is used for authenticating API requests
idID of the alert that attachment will be added.
aliasAlias of the alert that attachment will be added.
tinyIdshort ID assigned to the alert. All requests support tinyId but using this field is not recommended because it rolls.
attachmentAttachment file content

🚧

One of id, alias or tinyId parameters should be specified with attach file request. Alias option can only be used for open alerts

Optional Parameters

Parameter
userDefault owner of the execution. If user is not specified, the system becomes owner of the execution.
sourceUser defined field to specify source of atatch action.
indexFileName of html file which will be shown when attachment clicked on UI.
If it is not specified, following rules will be applied by order to determine index file name
1. if it is not a zip file, it will be assigned to
attachment file name
2. If it is a zip file, it will be assigned to
1. HTML file whose name equals
attachment file name
2. index.htm or index.html file
3. the first HTML file found in the ZIP
4. If no HTML file exists, it will be assigned
to attachment zip file name and zip file will
be downloaded from OpsGenie web site
directly when clicked on attachment.
noteAdditional alert note

Sample Request

curl -XPOST 'https://api.opsgenie.com/v1/json/alert/attach' -F apiKey="eb243592-faa2-4ba2-a551q-1afdf565c889" -F id="ac463592-dbd2-4ca3-a651d-48fhf5j5c871" -F attachment=@/opt/trial.txt

Response

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

Escalate to Next Request

Escalate to Next request is used to immediately process the next available rule in the specified escalation. It takes the following parameters:

For more details see Escalate to Next documentation page

Mandatory Parameters

Parameter
apiKeyAPI key is used for authenticating API requests
idID of the alert that details will be added.
aliasAlias of the alert that details will be added.
tinyIdshort ID assigned to the alert. All requests support tinyId but using this field is not recommended because it rolls.
escalationIdID of the escalation that will be escalated to the next level.
escalationNameName of the escalation that will be escalated to the next level.

🚧

One of id, alias or tinyId parameters should be specified with escalate to next request. Alias option can only be used for open alerts

🚧

One of escalationId or escalationName parameters should be specified with escalate to next request.

Optional Parameters

Parameter
userDefault owner of the execution. If user is not specified, the system becomes owner of the execution.
noteAdditional alert note
sourceUser defined field to specify source of unacknowledge action.

Sample Request

curl -XPOST 'https://api.opsgenie.com/v1/json/alert/escalateToNext' -d '
{
     "apiKey": "eb243592-faa2-4ba2-a551q-1afdf565c889",
     "id": "ac463592-dbd2-4ca3-a651d-48fhf5j5c871",
     "escalationId": "a915eb9c-60da-4be9-a98f-cfcd206b421d"
}'

Response

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