View all connectors

Opsgenie

By integrating Opsgenie with DX, you can analyze incident data and metrics such as MTTR and Change Fail Rate, as well as incorporate incident data into DX scorecards. Please refer to the API documentation below and our schema explorer to see what data DX imports.

Prerequisites

To connect Opsgenie to DX, you need:

  • an Opsgenie service account

Setup instructions

Follow the steps below to connect Opsgenie to DX.

Step 1

Create an Opsgenie service account with global admin status that will be used for DX.

Step 2

Login to the Opsgenie account created in the previous step and navigate to Settings > API key management, then click ‘Add new API Key’ and generate a new key with rights to both Read and Configuration access rights.

Step 3

  • Navigate to the connections page in DX and select “+ Connection” in the top right.
  • Enter the credentials you have generated in the previous steps—refer to the information below for errors and troubleshooting.

API reference

The table below lists the specific API endpoints that are used by DX.

Endpoint Documentation
/workspaces Link
/workspaces/{workspace_id}/tasks/search Link
/users Link
/teams/{team_id}/projects Link
/workspaces/{workspace_id}/teams Link
/teams/{team_id}/team_memberships Link
/projects/ Link
/tasks/{task_id}/status_updates Link
/tasks/{task_id}/stories Link
/projects/{project_id}/sections Link
/workspaces/{workspace_id}/custom_fields Link

Errors

The table below lists potential error codes when adding a connection in DX.

Error Description
invalid_credentials Your API credentials entered are not valid.
invalid_permissions Your API token does not have the permissions required by DX.