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.
Add a Forwarding Rule
Add a forwarding rule to OpsGenie to forward notifications of one user to another. It takes the following parameters:
Mandatory Parameters
Parameter | |
|---|---|
apiKey | API key is used for authenticating API requests |
fromUser | The username of user whose notifications will be forwarded |
toUser | The username of user who will receive the forwarded notifications |
startDate | The date and time for forwarding will start |
endDate | The date and time for forwarding will end |
Optional Parameters
Parameter | Limit | |
|---|---|---|
alias | 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 |
timezone | The timezone of the start and end date and time is specified. If not provided, the user's timezone is used. Please look at Supported Timezone IDs for available timezones. |
Sample Request
curl -XPOST 'https://api.opsgenie.com/v1/json/user/forward' -d '
{
"apiKey": "eb243592-faa2-4ba2-a551q-1afdf565c889",
"alias": "filiRule1",
"fromUser" : "[email protected]",
"toUser" : "[email protected]",
"startDate" : "2013-01-27 22:00",
"endDate" : "2013-01-28 08:00",
"timezone" : "GMT+2"
}'
Response
{
"id" : "c6de10d6-55d7-4d03-9d30-f7d8ceed7ba5",
"alias" : "filiRule1",
"status" : "successful",
"code" : 200
}
Update a Forwarding Rule
Updates a forwarding rule. It takes the following parameters:
Mandatory Parameters
Parameter | Limit | |
|---|---|---|
apiKey | API key is used for authenticating API requests | |
alias | 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 |
id | ID of forwarding rule | |
fromUser | The user whose notifications will be forwarded | |
toUser | The user who will receive the forwarded notifications | |
startDate | The date and time for forwarding will start | |
endDate | The date and time forwarding will end |
One of id or alias parameters should be specified with update forwarding rule request
Optional Parameters
Parameter | |
|---|---|
timezone | The timezone of the start and end date and time is specified. If not provided, the user's timezone is used. Please look at Supported Timezone IDs for available timezones. |
Sample Request
curl -XPOST 'https://api.opsgenie.com/v1/json/user/forward' -d '
{
"apiKey": "eb243592-faa2-4ba2-a551q-1afdf565c889",
"alias": "filiRule1",
"fromUser" : "[email protected]",
"toUser" : "[email protected]",
"startDate" : "2013-01-27 22:00",
"endDate" : "2013-01-28 08:00",
"timezone" : "GMT+2"
}'
Response:
{
"id" : "c6de10d6-55d7-4d03-9d30-f7d8ceed7ba5",
"alias" : "filiRule1",
"status" : "successful",
"code" : 200
}
Delete a Forwarding Rule
Delete a forwarding rule. It takes the following parameters:
Mandatory Parameters
Parameter | |
|---|---|
apiKey | API key is used for authenticating API requests |
alias | Alias of forwarding rule |
id | Id of forwarding rule |
One of id or alias parameters should be specified with delete forwarding rule request
Sample Request
curl -XDELETE 'https://api.opsgenie.com/v1/json/user/forward?apiKey=eb243592-faa2-4ba2-a551q-1afdf565c889&alias=filiRule1'
Response:
{
"status" : "successful",
"code" : 200
}
Get a Forwarding Rule
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 a forwarding rule. It takes the following parameters:
Mandatory Parameters
Parameter | |
|---|---|
apiKey | API key is used for authenticating API requests |
alias | Alias of forwarding rule |
id | Id of forwarding rule |
One of id or alias parameters should be specified with get forwarding rule request
Sample Request
curl -XGET 'https://api.opsgenie.com/v1/json/user/forward?apiKey=eb243592-faa2-4ba2-a551q-1afdf565c889&alias=filiRule1'
Response:
{
"alias": "filiRule1",
"id" : "1234abc",
"fromUser" : "[email protected]",
"toUser" : "[email protected]",
"startDate" : "2013-01-27 22:00",
"endDate" : "2013-01-28 08:00",
"timezone" : "GMT+2"
}
List Forwarding Rules
This is a read request. Therefore, even if the integration of the API key is configured as read-only, the request will be accepted.
Gets the list of existing forwarding rules for all the users in the account. It takes the following parameters:
Mandatory Parameters
Parameter | |
|---|---|
apiKey | API key is used for authenticating API requests |
Sample Request
curl -XGET 'https://api.opsgenie.com/v1/json/user/forward?apiKey=eb243592-faa2-4ba2-a551q-1afdf565c889'
Response:
{
"forwardings": [
{
"toUser": "[email protected]",
"fromUser": "[email protected]",
"endDate": "2016-08-26 00:00",
"timezone": "Europe/Minsk",
"alias": "",
"id": "cd6f0fc3-8b5e-4f7f-9841-a53cf3dc7c46",
"confirmed": true,
"startDate": "2016-08-24 00:00"
},
{
"toUser": "[email protected]",
"fromUser": "[email protected]",
"endDate": "2016-08-30 00:00",
"timezone": "Europe/Minsk",
"alias": "",
"id": "088331e7-2a35-49ce-a1f0-471822505dfa",
"confirmed": true,
"startDate": "2016-08-24 00:00"
}
]
}
List Forwarding Rules for a User
This is a read request. Therefore, even if the integration of the API key is configured as read-only, the request will be accepted.
Gets the list of existing forwarding rules for a specific user. It takes the following parameters:
Mandatory Parameters
Parameter | |
|---|---|
apiKey | API key is used for authenticating API requests |
user | The username of user that the forwarding rules will be listed for |
Sample Request
curl -XGET 'https://api.opsgenie.com/v1/json/user/forward?apiKey=eb243592-faa2-4ba2-a551q-1afdf565c889&[email protected]'
Response:
{
"forwardings": [
{
"toUser": "[email protected]",
"fromUser": "[email protected]",
"endDate": "2016-08-30 00:00",
"timezone": "Europe/Minsk",
"alias": "",
"id": "088331e7-2a35-49ce-a1f0-471822505dfa",
"confirmed": true,
"startDate": "2016-08-24 00:00"
}
]
}
Updated about a year ago