createIncident
Generate a new incident with details like title, severity, and status using Rootly MCP server. Provides structured responses for success, unauthorized access, or invalid data.
Instructions
Creates a new incident from provided data
Responses:
- 201 (Success): incident created
- Content-Type:
application/vnd.api+json
- Example:
- Content-Type:
{
"key": "value"
}
- 401: responds with unauthorized for invalid token
- Content-Type:
application/vnd.api+json
- Example:
- Content-Type:
{
"key": "value"
}
- 422: invalid causes association
- 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": {
"acknowledged_at": {
"description": "Date of acknowledgment",
"nullable": true,
"type": "string"
},
"cancelled_at": {
"description": "Date of cancellation",
"nullable": true,
"type": "string"
},
"cause_ids": {
"description": "The Cause ID's to attach to the incident",
"items": {
"type": "string"
},
"nullable": true,
"type": "array"
},
"detected_at": {
"description": "Date of detection",
"nullable": true,
"type": "string"
},
"duplicate_incident_id": {
"description": "ID of duplicated incident",
"nullable": true,
"type": "string"
},
"environment_ids": {
"description": "The Environment ID's to attach to the incident",
"items": {
"type": "string"
},
"nullable": true,
"type": "array"
},
"functionality_ids": {
"description": "The Functionality ID's to attach to the incident",
"items": {
"type": "string"
},
"nullable": true,
"type": "array"
},
"group_ids": {
"description": "The Team ID's to attach to the incident",
"items": {
"type": "string"
},
"nullable": true,
"type": "array"
},
"in_triage_at": {
"description": "Date of triage",
"nullable": true,
"type": "string"
},
"incident_type_ids": {
"description": "The Incident Type ID's to attach to the incident",
"items": {
"type": "string"
},
"nullable": true,
"type": "array"
},
"kind": {
"default": "normal",
"description": "The kind of the incident",
"enum": [
"test",
"test_sub",
"example",
"example_sub",
"normal",
"normal_sub",
"backfilled",
"scheduled"
],
"nullable": true,
"type": "string"
},
"labels": {
"description": "Labels to attach to the incidents. eg: {\"platform\":\"osx\", \"version\": \"1.29\"}",
"nullable": true,
"type": "object"
},
"mitigated_at": {
"description": "Date of mitigation",
"nullable": true,
"type": "string"
},
"notify_emails": {
"description": "Emails you want to notify",
"items": {
"type": "string"
},
"nullable": true,
"type": "array"
},
"parent_incident_id": {
"description": "ID of parent incident",
"nullable": true,
"type": "string"
},
"private": {
"default": false,
"description": "Create an incident as private. Once an incident is made as private it cannot be undone",
"nullable": true,
"type": "boolean"
},
"resolved_at": {
"description": "Date of resolution",
"nullable": true,
"type": "string"
},
"scheduled_for": {
"description": "Date of when the maintenance begins",
"nullable": true,
"type": "string"
},
"scheduled_until": {
"description": "Date of when the maintenance ends",
"nullable": true,
"type": "string"
},
"service_ids": {
"description": "The Service ID's to attach to the incident",
"items": {
"type": "string"
},
"nullable": true,
"type": "array"
},
"severity_id": {
"description": "The Severity ID to attach to the incident",
"nullable": true,
"type": "string"
},
"slack_channel_name": {
"description": "Slack channel name",
"nullable": true,
"type": "string"
},
"started_at": {
"description": "Date of start",
"nullable": true,
"type": "string"
},
"status": {
"description": "The status of the incident",
"enum": [
"in_triage",
"started",
"detected",
"acknowledged",
"mitigated",
"resolved",
"closed",
"cancelled",
"scheduled",
"in_progress",
"completed"
],
"type": "string"
},
"summary": {
"description": "The summary of the incident",
"nullable": true,
"type": "string"
},
"title": {
"description": "The title of the incident. We will autogenerate one if null",
"nullable": true,
"type": "string"
},
"url": {
"description": "The url to the incident",
"type": "string"
},
"user_id": {
"description": "User ID of the creator of the incident. Default to the user attached to the Api Key",
"nullable": true,
"type": "string"
}
},
"type": "object"
},
"type": {
"enum": [
"incidents"
],
"type": "string"
}
},
"required": [
"type",
"attributes"
],
"type": "object"
}
},
"required": [
"data"
],
"type": "object"
}