Forwarding Rule API

🚧
If using the EU instance of Opsgenie, the URL needs to be https://api.eu.opsgenie.com for requests to be successful.

General Information

📘
Create an API Integration and obtain your apiKey to make requests listed above. Please make sure that the integration is not restricted to access configurations.

Create Forwarding Rule

Create forwarding rule request is used to add new forwarding rules in Opsgenie and it is a write request. If the integration of the API key configured as read-only, the request will not be accepted. For more information, you can refer to API Access Management

HTTP Method	URL
POST	https://api.opsgenie.com/v2/forwarding-rules

JSON Body Fields

Fields	Mandatory	Description	Limit
fromUser	true	The user object of user whose notifications will be forwarded. You can refer to here for more details of user object
toUser	true	The user object of user who will receive the forwarded notifications. You can refer to here for more details of user object
startDate	true	The date and time for forwarding will start, which takes a date format as (yyyy-MM-dd'T'HH:mm:ssZ) (e.g. 2017-01-15T08:00:00+02:00)
endDate	true	The date and time for forwarding will end, which takes a date format as (yyyy-MM-dd'T'HH:mm:ssZ) (e.g. 2017-01-15T08:00:00+02:00)
alias	false	A user defined identifier for the forwarding rule. There can be only one forwarding rule with the same alias. Provides ability to assign a known id and later use this id to perform additional actions such as update the rule, etc.	512 chars

Sample Request

curl -X POST 'https://api.opsgenie.com/v2/forwarding-rules'
    --header 'Authorization: GenieKey eb243592-faa2-4ba2-a551q-1afdf565c889'
    --header 'Content-Type: application/json'
    --data
'{
    "fromUser" : {
        "id" : "ac8f4bf1-77ec-4a6d-9805-9c0a9c0d0d24"
    },
    "toUser" : {
        "id" : "a65c6b81-ffbf-41bd-b674-b06de5d90c26"
    },
    "alias" : "ruleAlias",
    "startDate" : "2017-07-05T08:00:00Z",
    "endDate" : "2017-07-06T18:00:00Z"
}'

Response:

{
    "data": {
        "alias": "ruleAlias",
        "id": "6667cb5b-a5ce-4550-9469-1dbcabac6ffb"
    },
    "took": 9.297,
    "requestId": "387dc75c-1138-4733-b5bd-5c9cce1ac715"
}

Get Forwarding Rule

Get forwarding rule request is used to search and retrieve forwarding rules in OpsGenie

HTTP Method	URL
GET	https://api.opsgenie.com/v2/forwarding-rules/:identifier

In-Line Parameters

Referred Name	Description
identifier	Identifier of the forwarding rule

Query Parameters

Parameter	Mandatory	Description
identifierType	false	Type of the identifier that is provided as an in-line parameter. Possible values are id and alias. Default value is id

Sample Request

curl -X GET 'https://api.opsgenie.com/v2/forwarding-rules/6667cb5b-a5ce-4550-9469-1dbcabac6ffb'
    --header 'Authorization: GenieKey eb243592-faa2-4ba2-a551q-1afdf565c889'

Sample Request With identifierType

curl -X GET 'https://api.opsgenie.com/v2/forwarding-rules/ruleAlias?identifierType=alias'
    --header 'Authorization: GenieKey eb243592-faa2-4ba2-a551q-1afdf565c889'

Response:

{
    "data": {
        "fromUser": {
            "id": "e58d6ee3-37bd-432f-9ded-64808b761ae0",
            "username": "[email protected]"
        },
        "toUser": {
            "id": "4b26961a-a837-49d2-a1fe-0973013e3c3b",
            "username": "[email protected]"
        },
        "startDate": "2017-07-05T08:00:00Z",
        "endDate": "2017-07-06T18:00:00Z",
        "alias": "ruleAlias",
        "id": "6667cb5b-a5ce-4550-9469-1dbcabac6ffb"
    },
    "took": 0.119,
    "requestId": "58688d8f-e4bd-402e-a25f-9999a774e0af"
}

Update Forwarding Rule

Update forwarding rule request is used to update forwarding rule and it is a write request. If the integration of the API key configured as read-only, the request will not be accepted. For more information, you can refer to API Access Management

HTTP Method	URL
PUT	https://api.opsgenie.com/v2/forwarding-rules/:identifier

In-Line Parameters

Referred Name	Description
identifier	Identifier of the forwarding rule

Query Parameters

Parameter	Mandatory	Description
identifierType	false	Type of the identifier that is provided as an in-line parameter. Possible values are id and alias. Default value is id

JSON Body Fields

Fields	Mandatory	Description
fromUser	true	The user object of user whose notifications will be forwarded. You can refer to here for more details of user object.
toUser	true	The user object of user who will receive the forwarded notifications. You can refer to here for more details of user object.
startDate	true	The date and time for forwarding will start, which takes a date format as (yyyy-MM-dd'T'HH:mm:ssZ) (e.g. 2017-01-15T08:00:00+02:00)
endDate	true	The date and time for forwarding will end, which takes a date format as (yyyy-MM-dd'T'HH:mm:ssZ) (e.g. 2017-01-15T08:00:00+02:00)

Sample Request

curl -X PUT 'https://api.opsgenie.com/v2/forwarding-rules/6667cb5b-a5ce-4550-9469-1dbcabac6ffb'
    --header 'Authorization: GenieKey eb243592-faa2-4ba2-a551q-1afdf565c889'
    --header 'Content-Type: application/json'
    --data '
{
    "fromUser" : {
        "username" : "[email protected]"
    },
    "toUser" : {
        "username" : "[email protected]"
    },
    "startDate" : "2017-07-07T08:00:00Z",
    "endDate" : "2017-07-08T08:00:00Z"
}'

Response:

{
    "data": {
        "alias": "ruleAlias",
        "id": "6667cb5b-a5ce-4550-9469-1dbcabac6ffb"
    },
    "took": 3.375,
    "requestId": "a6fa2988-8023-47b5-94a5-84af6a657384"
}

Delete Forwarding Rule

Delete forwarding rule request is used to delete forwarding rules in OpsGenie and it is a write request. If the integration of the API key configured as read-only, the request will not be accepted. For more information, you can refer to API Access Management

HTTP Method	URL
DELETE	https://api.opsgenie.com/v2/forwarding-rules/:identifier

In-Line Parameters

Referred Name	Description
identifier	Identifier of the forwarding rule

Query Parameters

Parameter	Mandatory	Description
identifierType	false	Type of the identifier that is provided as an in-line parameter. Possible values are id and alias. Default value is id

Sample Request

curl -X DELETE 'https://api.opsgenie.com/v2/forwarding-rules/6667cb5b-a5ce-4550-9469-1dbcabac6ffb'
    --header 'Authorization: GenieKey eb243592-faa2-4ba2-a551q-1afdf565c889'

Response:

{
    "result": "Deleted",
    "took": 1.208,
    "requestId": "7c02f0d9-c765-430f-90ef-a2d2465fdbe9"
}

List Forwarding Rules

List forwarding rules request is used to list forwarding rules in OpsGenie.

HTTP Method	URL
GET	https://api.opsgenie.com/v2/forwarding-rules

Sample Request

curl -X GET 'https://api.opsgenie.com/v2/forwarding-rules'
    --header 'Authorization: GenieKey eb243592-faa2-4ba2-a551q-1afdf565c889'

Response:

{
    "data": [
        {
            "fromUser": {
                "id": "e58d6ee3-37bd-432f-9ded-64808b761ae0",
                "username": "[email protected]"
            },
            "toUser": {
                "id": "4b26961a-a837-49d2-a1fe-0973013e3c3b",
                "username": "[email protected]"
            },
            "startDate": "2017-05-08T21:00:00Z",
            "endDate": "2017-05-09T21:00:00Z",
            "alias": "",
            "id": "5c4694d5-37a4-4ada-99cc-0652296e9397"
        },
        {
            "fromUser": {
                "id": "e58d6ee3-37bd-432f-9ded-64808b761ae0",
                "username": "[email protected]"
            },
            "toUser": {
                "id": "4b26961a-a837-49d2-a1fe-0973013e3c3b",
                "username": "[email protected]"
            },
            "startDate": "2017-05-22T21:00:00Z",
            "endDate": "2017-05-24T21:00:00Z",
            "alias": "",
            "id": "e2a4ea3a-7abb-4bb9-8a05-00de82de544d"
        }
    ],
    "took": 0.212,
    "requestId": "cf4ad4dc-4dcd-4a0c-b50b-0cc5ea8f4091"
}

Fields of User Object

This object is used by fromUser and toUser fields. User object should have the following format:

Field	Mandatory	Description
id	false	This parameter is the id of the user.
username	false	This parameter is the username of the user.

🚧
One of id or username fields should be specified in user object.