createAlert
Generate and manage alerts in Rootly MCP server by defining source, summary, and additional attributes to streamline incident tracking and response.
Instructions
Creates a new alert from provided data
Responses:
- 201 (Success): alert created
- Content-Type:
application/vnd.api+json
- Example:
- Content-Type:
{
"key": "value"
}
- 401: resource not found
- Content-Type:
application/vnd.api+json
- Example:
- Content-Type:
{
"key": "value"
}
- 422: invalid request
- Content-Type:
application/vnd.api+json
- Example:
- Content-Type:
{
"key": "value"
}
Input Schema
Name | Required | Description | Default |
---|---|---|---|
data | Yes |
Input Schema (JSON Schema)
{
"properties": {
"data": {
"properties": {
"attributes": {
"additionalProperties": false,
"properties": {
"alert_urgency_id": {
"description": "The ID of the alert urgency",
"nullable": true,
"type": "string"
},
"data": {
"description": "Additional data",
"nullable": true,
"type": "object"
},
"description": {
"description": "The description of the alert",
"nullable": true,
"type": "string"
},
"ended_at": {
"description": "Alert end datetime",
"format": "date-time",
"nullable": true,
"type": "string"
},
"environment_ids": {
"description": "The Environment ID's to attach to the alert",
"items": {
"type": "string"
},
"nullable": true,
"type": "array"
},
"external_id": {
"description": "External ID",
"nullable": true,
"type": "string"
},
"external_url": {
"description": "External Url",
"nullable": true,
"type": "string"
},
"group_ids": {
"description": "The Group ID's to attach to the alert. If your organization has On-Call enabled and your notification target is a Group. This field will be automatically set for you.",
"items": {
"type": "string"
},
"nullable": true,
"type": "array"
},
"labels": {
"items": {
"nullable": true,
"properties": {
"key": {
"description": "Key of the tag",
"type": "string"
},
"value": {
"description": "Value of the tag",
"type": "string"
}
},
"required": [
"key",
"value"
],
"type": "object"
},
"type": "array"
},
"noise": {
"description": "Whether the alert is marked as noise",
"enum": [
"noise",
"not_noise"
],
"nullable": true,
"type": "string"
},
"notification_target_id": {
"description": "Only available for organizations with Rootly On-Call enabled. The _identifier_ of the notification target object.",
"nullable": true,
"type": "string"
},
"notification_target_type": {
"description": "Only available for organizations with Rootly On-Call enabled. Can be one of Group, Service, EscalationPolicy, User.",
"enum": [
"User",
"Group",
"EscalationPolicy",
"Service"
],
"nullable": true,
"type": "string"
},
"service_ids": {
"description": "The Service ID's to attach to the alert. If your organization has On-Call enabled and your notification target is a Service. This field will be automatically set for you.",
"items": {
"type": "string"
},
"nullable": true,
"type": "array"
},
"source": {
"description": "The source of the alert",
"enum": [
"rootly",
"manual",
"web",
"slack",
"email",
"workflow",
"live_call_routing",
"email",
"pagerduty",
"opsgenie",
"victorops",
"pagertree",
"datadog",
"nobl9",
"zendesk",
"asana",
"clickup",
"sentry",
"rollbar",
"jira",
"honeycomb",
"service_now",
"linear",
"grafana",
"alertmanager",
"google_cloud",
"generic_webhook",
"cloud_watch",
"azure",
"splunk",
"chronosphere",
"app_optics",
"bug_snag",
"monte_carlo",
"nagios",
"prtg",
"catchpoint",
"app_dynamics"
],
"type": "string"
},
"started_at": {
"description": "Alert start datetime",
"format": "date-time",
"nullable": true,
"type": "string"
},
"status": {
"description": "Only available for organizations with Rootly On-Call enabled. Can be one of open, triggered, acknowledged or resolved.",
"enum": [
"open",
"triggered"
],
"type": "string"
},
"summary": {
"description": "The summary of the alert",
"type": "string"
}
},
"required": [
"source",
"summary"
],
"type": "object"
},
"type": {
"enum": [
"alerts"
],
"type": "string"
}
},
"required": [
"type",
"attributes"
],
"type": "object"
}
},
"required": [
"data"
],
"type": "object"
}