Alert Sources V2

Configure your alert sources in incident.io.

Alert sources are the systems that send alerts to incident.io, which can then be routed to the right people and teams.

List Alert Sources V2

List all alert sources in your account.

Responses

200

OK response.

get/v2/alert_sources

Request samples

curl

Response samples

application/json

{"alert_sources": [{"email_options": {"email_address": "lawrence@example.com"
},
"id": "01GW2G3V0S59R238FAHPDS1R66",
"jira_options": {"project_ids": ["01GBSQF3FHF7FWZQNWGHAVQ804",
"10043"
]
},
"name": "Production Web Dashboard Alerts",
"secret_token": "some-secret-token",
"source_type": "app_optics",
"template": {"attributes": [{"alert_attribute_id": "abc123",
"binding": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
}
],
"description": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
},
"expressions": [{"else_branch": {"result": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
},
"label": "Team Slack channel",
"operations": [{"branches": {"branches": [{"condition_groups": [{"conditions": [{"operation": {"label": "Lawrence Jones",
"value": "01FCQSP07Z74QMMYPDDGQB9FTG"
},
"param_bindings": [{"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
],
"subject": {"label": "Incident Severity",
"reference": "incident.severity"
}
}
]
}
],
"result": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
}
],
"returns": {"array": true,
"type": "IncidentStatus"
}
},
"filter": {"condition_groups": [{"conditions": [{"operation": {"label": "Lawrence Jones",
"value": "01FCQSP07Z74QMMYPDDGQB9FTG"
},
"param_bindings": [{"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
],
"subject": {"label": "Incident Severity",
"reference": "incident.severity"
}
}
]
}
]
},
"navigate": {"reference": "1235",
"reference_label": "Teams"
},
"operation_type": "navigate",
"parse": {"returns": {"array": true,
"type": "IncidentStatus"
},
"source": "metadata.annotations[\"github.com/repo\"]"
},
"returns": {"array": true,
"type": "IncidentStatus"
}
}
],
"reference": "abc123",
"returns": {"array": true,
"type": "IncidentStatus"
},
"root_reference": "incident.status"
}
],
"title": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
}
]
}

Create Alert Sources V2

Create a new alert source in your account.

Request

Request Body schema: application/json
required

	object (AlertSourceJiraOptionsV2)
name required	string Unique name of the alert source
source_type required	string Type of alert source Enum: "alertmanager" "app_optics" "azure_monitor" "bugsnag" "checkly" "chronosphere" "cloudwatch" "cloudflare" "cronitor" "crowdstrike_falcon" "datadog" "dynatrace" "elasticsearch" "email" "expel" "github_issue" "google_cloud" "grafana" "http" "honeycomb" "incoming_calls" "jira" "monte_carlo" "nagios" "new_relic" "opsgenie" "prtg" "pager_duty" "panther" "pingdom" "runscope" "sns" "sentry" "splunk" "status_cake" "status_page_views" "sumo_logic" "uptime" "zendesk"
required	object (AlertTemplatePayloadV2)

Responses

200

OK response.

post/v2/alert_sources

Request samples

Payload
curl

application/json

{"jira_options": {"project_ids": ["01GBSQF3FHF7FWZQNWGHAVQ804",
"10043"
]
},
"name": "Production Web Dashboard Alerts",
"source_type": "app_optics",
"template": {"attributes": [{"alert_attribute_id": "abc123",
"binding": {"array_value": [{"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"literal": "SEV123",
"reference": "incident.severity"
}
}
}
],
"description": {"literal": "SEV123",
"reference": "incident.severity"
},
"expressions": [{"else_branch": {"result": {"array_value": [{"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"literal": "SEV123",
"reference": "incident.severity"
}
}
},
"label": "Team Slack channel",
"operations": [{"branches": {"branches": [{"condition_groups": [{"conditions": [{"operation": "one_of",
"param_bindings": [{"array_value": [{"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"literal": "SEV123",
"reference": "incident.severity"
}
}
],
"subject": "incident.severity"
}
]
}
],
"result": {"array_value": [{"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"literal": "SEV123",
"reference": "incident.severity"
}
}
}
],
"returns": {"array": true,
"type": "IncidentStatus"
}
},
"filter": {"condition_groups": [{"conditions": [{"operation": "one_of",
"param_bindings": [{"array_value": [{"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"literal": "SEV123",
"reference": "incident.severity"
}
}
],
"subject": "incident.severity"
}
]
}
]
},
"navigate": {"reference": "catalog_attribute[\"01FCNDV6P870EA6S7TK1DSYD5H\"]"
},
"operation_type": "navigate",
"parse": {"returns": {"array": true,
"type": "IncidentStatus"
},
"source": "metadata.annotations[\"github.com/repo\"]"
}
}
],
"reference": "abc123",
"root_reference": "incident.status"
}
],
"title": {"literal": "SEV123",
"reference": "incident.severity"
}
}
}

Response samples

application/json

{"alert_source": {"email_options": {"email_address": "lawrence@example.com"
},
"id": "01GW2G3V0S59R238FAHPDS1R66",
"jira_options": {"project_ids": ["01GBSQF3FHF7FWZQNWGHAVQ804",
"10043"
]
},
"name": "Production Web Dashboard Alerts",
"secret_token": "some-secret-token",
"source_type": "app_optics",
"template": {"attributes": [{"alert_attribute_id": "abc123",
"binding": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
}
],
"description": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
},
"expressions": [{"else_branch": {"result": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
},
"label": "Team Slack channel",
"operations": [{"branches": {"branches": [{"condition_groups": [{"conditions": [{"operation": {"label": "Lawrence Jones",
"value": "01FCQSP07Z74QMMYPDDGQB9FTG"
},
"param_bindings": [{"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
],
"subject": {"label": "Incident Severity",
"reference": "incident.severity"
}
}
]
}
],
"result": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
}
],
"returns": {"array": true,
"type": "IncidentStatus"
}
},
"filter": {"condition_groups": [{"conditions": [{"operation": {"label": "Lawrence Jones",
"value": "01FCQSP07Z74QMMYPDDGQB9FTG"
},
"param_bindings": [{"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
],
"subject": {"label": "Incident Severity",
"reference": "incident.severity"
}
}
]
}
]
},
"navigate": {"reference": "1235",
"reference_label": "Teams"
},
"operation_type": "navigate",
"parse": {"returns": {"array": true,
"type": "IncidentStatus"
},
"source": "metadata.annotations[\"github.com/repo\"]"
},
"returns": {"array": true,
"type": "IncidentStatus"
}
}
],
"reference": "abc123",
"returns": {"array": true,
"type": "IncidentStatus"
},
"root_reference": "incident.status"
}
],
"title": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
}
}

Delete Alert Sources V2

Delete an existing alert source in your account.

Request

path Parameters

required

string

The ID of this alert source

Example: 01GW2G3V0S59R238FAHPDS1R66

Responses

204

No Content response.

delete/v2/alert_sources/{id}

Request samples

curl

Show Alert Sources V2

Load details about a specific alert source in your account.

Request

path Parameters

required

string

The ID of this alert source

Example: 01GW2G3V0S59R238FAHPDS1R66

Responses

200

OK response.

get/v2/alert_sources/{id}

Request samples

curl

Response samples

application/json

{"alert_source": {"email_options": {"email_address": "lawrence@example.com"
},
"id": "01GW2G3V0S59R238FAHPDS1R66",
"jira_options": {"project_ids": ["01GBSQF3FHF7FWZQNWGHAVQ804",
"10043"
]
},
"name": "Production Web Dashboard Alerts",
"secret_token": "some-secret-token",
"source_type": "app_optics",
"template": {"attributes": [{"alert_attribute_id": "abc123",
"binding": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
}
],
"description": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
},
"expressions": [{"else_branch": {"result": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
},
"label": "Team Slack channel",
"operations": [{"branches": {"branches": [{"condition_groups": [{"conditions": [{"operation": {"label": "Lawrence Jones",
"value": "01FCQSP07Z74QMMYPDDGQB9FTG"
},
"param_bindings": [{"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
],
"subject": {"label": "Incident Severity",
"reference": "incident.severity"
}
}
]
}
],
"result": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
}
],
"returns": {"array": true,
"type": "IncidentStatus"
}
},
"filter": {"condition_groups": [{"conditions": [{"operation": {"label": "Lawrence Jones",
"value": "01FCQSP07Z74QMMYPDDGQB9FTG"
},
"param_bindings": [{"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
],
"subject": {"label": "Incident Severity",
"reference": "incident.severity"
}
}
]
}
]
},
"navigate": {"reference": "1235",
"reference_label": "Teams"
},
"operation_type": "navigate",
"parse": {"returns": {"array": true,
"type": "IncidentStatus"
},
"source": "metadata.annotations[\"github.com/repo\"]"
},
"returns": {"array": true,
"type": "IncidentStatus"
}
}
],
"reference": "abc123",
"returns": {"array": true,
"type": "IncidentStatus"
},
"root_reference": "incident.status"
}
],
"title": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
}
}

Update Alert Sources V2

Update an existing alert source in your account.

Request

path Parameters

required

string

The ID of this alert source

Example: 01GW2G3V0S59R238FAHPDS1R66

Request Body schema: application/json
required

	object (AlertSourceJiraOptionsV2)
name required	string Unique name of the alert source
required	object (AlertTemplatePayloadV2)

Responses

200

OK response.

put/v2/alert_sources/{id}

Request samples

Payload
curl

application/json

{"jira_options": {"project_ids": ["01GBSQF3FHF7FWZQNWGHAVQ804",
"10043"
]
},
"name": "Production Web Dashboard Alerts",
"template": {"attributes": [{"alert_attribute_id": "abc123",
"binding": {"array_value": [{"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"literal": "SEV123",
"reference": "incident.severity"
}
}
}
],
"description": {"literal": "SEV123",
"reference": "incident.severity"
},
"expressions": [{"else_branch": {"result": {"array_value": [{"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"literal": "SEV123",
"reference": "incident.severity"
}
}
},
"label": "Team Slack channel",
"operations": [{"branches": {"branches": [{"condition_groups": [{"conditions": [{"operation": "one_of",
"param_bindings": [{"array_value": [{"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"literal": "SEV123",
"reference": "incident.severity"
}
}
],
"subject": "incident.severity"
}
]
}
],
"result": {"array_value": [{"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"literal": "SEV123",
"reference": "incident.severity"
}
}
}
],
"returns": {"array": true,
"type": "IncidentStatus"
}
},
"filter": {"condition_groups": [{"conditions": [{"operation": "one_of",
"param_bindings": [{"array_value": [{"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"literal": "SEV123",
"reference": "incident.severity"
}
}
],
"subject": "incident.severity"
}
]
}
]
},
"navigate": {"reference": "catalog_attribute[\"01FCNDV6P870EA6S7TK1DSYD5H\"]"
},
"operation_type": "navigate",
"parse": {"returns": {"array": true,
"type": "IncidentStatus"
},
"source": "metadata.annotations[\"github.com/repo\"]"
}
}
],
"reference": "abc123",
"root_reference": "incident.status"
}
],
"title": {"literal": "SEV123",
"reference": "incident.severity"
}
}
}

Response samples

application/json

{"alert_source": {"email_options": {"email_address": "lawrence@example.com"
},
"id": "01GW2G3V0S59R238FAHPDS1R66",
"jira_options": {"project_ids": ["01GBSQF3FHF7FWZQNWGHAVQ804",
"10043"
]
},
"name": "Production Web Dashboard Alerts",
"secret_token": "some-secret-token",
"source_type": "app_optics",
"template": {"attributes": [{"alert_attribute_id": "abc123",
"binding": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
}
],
"description": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
},
"expressions": [{"else_branch": {"result": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
},
"label": "Team Slack channel",
"operations": [{"branches": {"branches": [{"condition_groups": [{"conditions": [{"operation": {"label": "Lawrence Jones",
"value": "01FCQSP07Z74QMMYPDDGQB9FTG"
},
"param_bindings": [{"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
],
"subject": {"label": "Incident Severity",
"reference": "incident.severity"
}
}
]
}
],
"result": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
}
],
"returns": {"array": true,
"type": "IncidentStatus"
}
},
"filter": {"condition_groups": [{"conditions": [{"operation": {"label": "Lawrence Jones",
"value": "01FCQSP07Z74QMMYPDDGQB9FTG"
},
"param_bindings": [{"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
],
"subject": {"label": "Incident Severity",
"reference": "incident.severity"
}
}
]
}
]
},
"navigate": {"reference": "1235",
"reference_label": "Teams"
},
"operation_type": "navigate",
"parse": {"returns": {"array": true,
"type": "IncidentStatus"
},
"source": "metadata.annotations[\"github.com/repo\"]"
},
"returns": {"array": true,
"type": "IncidentStatus"
}
}
],
"reference": "abc123",
"returns": {"array": true,
"type": "IncidentStatus"
},
"root_reference": "incident.status"
}
],
"title": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
}
}

➔ Next to Catalog V2

Alert Sources V2

List Alert Sources V2

Create Alert Sources V2

Request Body schema: application/jsonrequired

Delete Alert Sources V2

path Parameters

Show Alert Sources V2

path Parameters

Update Alert Sources V2

path Parameters

Request Body schema: application/jsonrequired

Request Body schema: application/json
required

Request Body schema: application/json
required