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 Schedule Override
Creates a schedule override for the specified user and schedule. It takes the following parameters:
Mandatory Parameters
Parameter | |
---|---|
apiKey | API key is used for authenticating API requests |
alias | A user defined identifier for the override. There can be only one override with the same alias for that schedule. Provides ability to assign a known id and later use this id to perform additional actions such as update, get, etc. |
schedule | Id or name of the schedule. |
user | The username of user who will take on call responsibility, or the reserved word none. |
startDate | The date and time for override will start |
endDate | The date and time override will end |
Optional Parameters
Parameter | |
---|---|
rotationIds | Id list of the rotations that override will apply. When it's set, only specified schedule rotations will be overridden. |
timezone | The timezone of the start and end date and time is specified. If not provided, the schedule's timezone is used. Please look here for available timezones. |
Sample Request
curl -XPOST 'https://api.opsgenie.com/v1/json/schedule/override' -d '
{
"apiKey": "eb243592-faa2-4ba2-a551q-1afdf565c889",
"alias": "override1",
"rotationIds": ["29c15643-7351-4337-ad6f-0fd8af8ea6e2", "1a9b4404-331a-4492-8da0-43ec20b7c0cf"]
"user" : "[email protected]",
"schedule" : "team1_schedule",
"startDate" : "2013-01-27 22:00",
"endDate" : "2013-01-28 08:00",
"timezone" : "GMT+2"
}'
Response:
{
"alias" : "override1",
"status" : "successful",
"code" : 200
}
Update Schedule Override
Updates a schedule override. It takes the following parameters:
Mandatory Parameters
Parameter | |
---|---|
apiKey | API key is used for authenticating API requests |
alias | A user defined identifier for the override. There can be only one override with the same alias for that schedule. Provides ability to assign a known id and later use this id to perform additional actions such as update, get etc. |
schedule | Id or name of the schedule. |
user | The username of user who will take on call responsibility, or the reserved word none. |
startDate | The date and time for override will start. |
endDate | The date and time override will end. |
Optional Parameters
Parameter | |
---|---|
rotationIds | Id list of the rotations that override will apply. When it's set, only specified schedule rotations will be overridden. |
timezone | The timezone of the start and end date and time is specified. If not provided, the schedule's timezone is used. Please look here for available timezones. |
Sample Request
curl -XPOST 'https://api.opsgenie.com/v1/json/schedule/override' -d '
{
"apiKey": "eb243592-faa2-4ba2-a551q-1afdf565c889",
"alias": "override1",
"rotationIds": ["29c15643-7351-4337-ad6f-0fd8af8ea6e2"]
"user" : "none",
"schedule" : "team1_schedule",
"startDate" : "2013-01-27 22:00",
"endDate" : "2013-01-28 08:00",
"timezone" : "GMT+2"
}'
Response:
{
"alias" : "override1",
"status" : "successful",
"code" : 200
}
Delete Schedule Override
Deletes a schedule override. It takes the following parameters:
Mandatory Parameters
Parameter | |
---|---|
apiKey | API key is used for authenticating API requests |
alias | Alias of the schedule override. |
schedule | Id or name of the schedule that the override belongs to. |
Sample Request
curl -XDELETE 'https://api.opsgenie.com/v1/json/schedule/override?apiKey=eb243592-faa2-4ba2-a551q-1afdf565c889&alias=override1&schedule=team1_schedule'
Response:
{
"status" : "successful",
"code" : 200
}
Get Schedule Override
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 schedule override details. It takes the following parameters:
Mandatory Parameters
Parameter | |
---|---|
apiKey | API key is used for authenticating API requests |
alias | Alias of the schedule override/td> |
schedule | Id or name of the schedule that the override belongs. |
Sample Request
curl -XGET 'https://api.opsgenie.com/v1/json/schedule/override?apiKey=eb243592-faa2-4ba2-a551q-1afdf565c889&alias=override1&schedule=team1_schedule'
Response:
{
"alias": "override1",
"user" : "[email protected]",
"rotationIds": ["29c15643-7351-4337-ad6f-0fd8af8ea6e2", "1a9b4404-331a-4492-8da0-43ec20b7c0cf"]
"startDate" : "2013-01-27 22:00",
"endDate" : "2013-01-28 08:00",
"timezone" : "GMT+2"
}
List Schedule Overrides
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 overrides for the specified schedule. It takes the following parameters:
Mandatory Parameters
Parameter | |
---|---|
apiKey | API key is used for authenticating API requests |
schedule | Id or name of the schedule. |
Sample Request
curl -XGET 'https://api.opsgenie.com/v1/json/schedule/override?apiKey=eb243592-faa2-4ba2-a551q-1afdf565c889&schedule=team1_schedule'
Response:
{
"overrides" : [
{
"alias": "override1",
"rotationIds": ["29c15643-7351-4337-ad6f-0fd8af8ea6e2", "1a9b4404-331a-4492-8da0-43ec20b7c0cf"]
"user" : "[email protected]",
"startDate" : "2013-01-27 22:00",
"endDate" : "2013-01-28 08:00",
"timezone" : "GMT+2"
},
{
"alias": "override2",
"rotationIds": [],
"user" : "none",
"startDate" : "2013-01-29 22:00",
"endDate" : "2013-01-30 08:00",
"timezone" : "GMT+2"
}
]
}
Updated about a year ago