Update PagerDuty incident

Update one incident. Requires write. Unsafe because PagerDuty does not guarantee replay idempotency.

incidents.update · PagerDuty · v1

Details

Risk: Write
Idempotency: Unsafe
Availability: Default
Exposure: REST, SDK
MCP hints: readOnly=false, destructive=false, idempotent=false, openWorld=true

Scopes

write

Input

Input schema
Name	Type	Required	Constraints
`(root)`	`object`	Yes	additionalProperties false; oneOf branch 1: required title / branch 2: required urgency / branch 3: required title, urgency / branch 4: required status / branch 5: required title, status / branch 6: required urgency, status / branch 7: required title, urgency, status / branch 8: required escalation_level / branch 9: required title, escalation_level / branch 10: required urgency, escalation_level / branch 11: required title, urgency, escalation_level / branch 12: required status, escalation_level / branch 13: required title, status, escalation_level / branch 14: required urgency, status, escalation_level / branch 15: required title, urgency, status, escalation_level / branch 16: required assignment_user_ids / branch 17: required title, assignment_user_ids / branch 18: required urgency, assignment_user_ids / branch 19: required title, urgency, assignment_user_ids / branch 20: required status, assignment_user_ids / branch 21: required title, status, assignment_user_ids / branch 22: required urgency, status, assignment_user_ids / branch 23: required title, urgency, status, assignment_user_ids / branch 24: required escalation_level, assignment_user_ids / branch 25: required title, escalation_level, assignment_user_ids / branch 26: required urgency, escalation_level, assignment_user_ids / branch 27: required title, urgency, escalation_level, assignment_user_ids / branch 28: required status, escalation_level, assignment_user_ids / branch 29: required title, status, escalation_level, assignment_user_ids / branch 30: required urgency, status, escalation_level, assignment_user_ids / branch 31: required title, urgency, status, escalation_level, assignment_user_ids
`incident_id`	`string`	Yes	minLength 1; maxLength 100
`title`	`string`	No	minLength 1; maxLength 1024
`urgency`	`string`	No	enum high \| low
`status`	`string`	No	enum acknowledged \| resolved
`escalation_level`	`integer`	No	minimum 0; maximum 99
`assignment_user_ids`	`array<string>`	No	minItems 1; maxItems 25
`assignment_user_ids[]`	`string`	Yes	minLength 1; maxLength 100

Output

Output schema
Name	Type	Required	Constraints
`(root)`	`object`	Yes	additionalProperties false
`id`	`string`	Yes	minLength 1; maxLength 100
`incident_number`	`integer`	Yes	minimum 1
`title`	`string`	Yes	minLength 1; maxLength 1024
`status`	`string`	Yes	minLength 1; maxLength 64
`urgency`	`string`	Yes	enum high \| low
`html_url`	`string`	Yes	maxLength 2048
`service`	`object`	Yes	additionalProperties false
`service.id`	`string`	Yes	minLength 1; maxLength 100
`service.summary`	`string`	Yes	minLength 1; maxLength 200
`service.html_url`	`string`	No	maxLength 2048
`service.type`	`string`	No	maxLength 64
`assignments`	`array<object>`	Yes	maxItems 25
`assignments[]`	`object`	Yes	additionalProperties false
`assignments[].assignee`	`object`	Yes	additionalProperties false
`assignments[].assignee.id`	`string`	Yes	minLength 1; maxLength 100
`assignments[].assignee.summary`	`string`	Yes	minLength 1; maxLength 200
`assignments[].assignee.html_url`	`string`	No	maxLength 2048
`assignments[].assignee.type`	`string`	No	maxLength 64
`assignments[].at`	`string`	No	minLength 1; maxLength 64
`escalation_policy`	`object`	No	additionalProperties false
`escalation_policy.id`	`string`	Yes	minLength 1; maxLength 100
`escalation_policy.summary`	`string`	Yes	minLength 1; maxLength 200
`escalation_policy.html_url`	`string`	No	maxLength 2048
`escalation_policy.type`	`string`	No	maxLength 64
`created_at`	`string`	Yes	minLength 1; maxLength 64
`updated_at`	`string`	No	minLength 1; maxLength 64
`resolved_at`	`string`	No	minLength 1; maxLength 64

Raw schema

Input

{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "incident_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "title": {
      "type": "string",
      "minLength": 1,
      "maxLength": 1024
    },
    "urgency": {
      "type": "string",
      "enum": [
        "high",
        "low"
      ]
    },
    "status": {
      "type": "string",
      "enum": [
        "acknowledged",
        "resolved"
      ]
    },
    "escalation_level": {
      "type": "integer",
      "minimum": 0,
      "maximum": 99
    },
    "assignment_user_ids": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 100
      },
      "minItems": 1,
      "maxItems": 25
    }
  },
  "required": [
    "incident_id"
  ],
  "oneOf": [
    {
      "required": [
        "title"
      ]
    },
    {
      "required": [
        "urgency"
      ]
    },
    {
      "required": [
        "title",
        "urgency"
      ]
    },
    {
      "required": [
        "status"
      ]
    },
    {
      "required": [
        "title",
        "status"
      ]
    },
    {
      "required": [
        "urgency",
        "status"
      ]
    },
    {
      "required": [
        "title",
        "urgency",
        "status"
      ]
    },
    {
      "required": [
        "escalation_level"
      ]
    },
    {
      "required": [
        "title",
        "escalation_level"
      ]
    },
    {
      "required": [
        "urgency",
        "escalation_level"
      ]
    },
    {
      "required": [
        "title",
        "urgency",
        "escalation_level"
      ]
    },
    {
      "required": [
        "status",
        "escalation_level"
      ]
    },
    {
      "required": [
        "title",
        "status",
        "escalation_level"
      ]
    },
    {
      "required": [
        "urgency",
        "status",
        "escalation_level"
      ]
    },
    {
      "required": [
        "title",
        "urgency",
        "status",
        "escalation_level"
      ]
    },
    {
      "required": [
        "assignment_user_ids"
      ]
    },
    {
      "required": [
        "title",
        "assignment_user_ids"
      ]
    },
    {
      "required": [
        "urgency",
        "assignment_user_ids"
      ]
    },
    {
      "required": [
        "title",
        "urgency",
        "assignment_user_ids"
      ]
    },
    {
      "required": [
        "status",
        "assignment_user_ids"
      ]
    },
    {
      "required": [
        "title",
        "status",
        "assignment_user_ids"
      ]
    },
    {
      "required": [
        "urgency",
        "status",
        "assignment_user_ids"
      ]
    },
    {
      "required": [
        "title",
        "urgency",
        "status",
        "assignment_user_ids"
      ]
    },
    {
      "required": [
        "escalation_level",
        "assignment_user_ids"
      ]
    },
    {
      "required": [
        "title",
        "escalation_level",
        "assignment_user_ids"
      ]
    },
    {
      "required": [
        "urgency",
        "escalation_level",
        "assignment_user_ids"
      ]
    },
    {
      "required": [
        "title",
        "urgency",
        "escalation_level",
        "assignment_user_ids"
      ]
    },
    {
      "required": [
        "status",
        "escalation_level",
        "assignment_user_ids"
      ]
    },
    {
      "required": [
        "title",
        "status",
        "escalation_level",
        "assignment_user_ids"
      ]
    },
    {
      "required": [
        "urgency",
        "status",
        "escalation_level",
        "assignment_user_ids"
      ]
    },
    {
      "required": [
        "title",
        "urgency",
        "status",
        "escalation_level",
        "assignment_user_ids"
      ]
    }
  ]
}

Output

{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "incident_number": {
      "type": "integer",
      "minimum": 1
    },
    "title": {
      "type": "string",
      "minLength": 1,
      "maxLength": 1024
    },
    "status": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "urgency": {
      "type": "string",
      "enum": [
        "high",
        "low"
      ]
    },
    "html_url": {
      "type": "string",
      "maxLength": 2048
    },
    "service": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "id": {
          "type": "string",
          "minLength": 1,
          "maxLength": 100
        },
        "summary": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200
        },
        "html_url": {
          "type": "string",
          "maxLength": 2048
        },
        "type": {
          "type": "string",
          "maxLength": 64
        }
      },
      "required": [
        "id",
        "summary"
      ]
    },
    "assignments": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "assignee": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "maxLength": 100
              },
              "summary": {
                "type": "string",
                "minLength": 1,
                "maxLength": 200
              },
              "html_url": {
                "type": "string",
                "maxLength": 2048
              },
              "type": {
                "type": "string",
                "maxLength": 64
              }
            },
            "required": [
              "id",
              "summary"
            ]
          },
          "at": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64
          }
        },
        "required": [
          "assignee"
        ]
      },
      "maxItems": 25
    },
    "escalation_policy": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "id": {
          "type": "string",
          "minLength": 1,
          "maxLength": 100
        },
        "summary": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200
        },
        "html_url": {
          "type": "string",
          "maxLength": 2048
        },
        "type": {
          "type": "string",
          "maxLength": 64
        }
      },
      "required": [
        "id",
        "summary"
      ]
    },
    "created_at": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "updated_at": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "resolved_at": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    }
  },
  "required": [
    "id",
    "incident_number",
    "title",
    "status",
    "urgency",
    "html_url",
    "service",
    "assignments",
    "created_at"
  ]
}

Update PagerDuty incident

Details

Scopes

Input

Output

Raw schema

On this page