OpsGenie Python SDK aims to access OpsGenie Web API through HTTP calls from a client application in Python language.

OpsGenie Python SDK covers:

• Alert API
• Heartbeat API (TODO: will be available soon)
• Integration API (TODO: will be available soon)
• Policy API (TODO: will be available soon)

Future releases are subject to be delivered for packing more APIs soon.

For more information about OpsGenie Python SDK, please refer to OpsGenie Python API document.

• The API is built for Python 2.7 but can also be used with other Python versions.
• Before you begin, you need to sign up OpsGenie if you don't have a valid account yet. Create an API Integration and get your API key.

To download all packages in the repo with their dependencies, simply execute

pip install opsgenie-sdk

One can start using OpsGenie Python SDK by initializing client and making a request. Example shown below demonstrates how to initialize an OpsGenie client and make a create alert request.

from opsgenie import OpsGenie
from opsgenie.alert.requests import CreateAlertRequest
from opsgenie.config import Configuration
from opsgenie.errors import OpsGenieError

config = Configuration("YOUR_API_KEY")

client = OpsGenie(config)

try:
    response = client.alert.create_alert(CreateAlertRequest(message="Hello from OpsGenie Python SDK"))
    print 'message: {}'.format(response.message)
    print 'alert id: {}'.format(response.alert_id)
    print 'status: {}'.format(response.status)
    print 'code: {}'.format(response.code)
except OpsGenieError as err:
    print err.message

There are useful sample code snippets under samples directory for packages.

Please follow the links below for more information and details about the Web API.

• Alert API
• Heartbeat API
• Integration API
• Policy API

If you like to report a bug, or a feature request; please open an issue.