Update Datadog monitor

Update mutable monitor fields. Requires monitors_write. Unsafe because Datadog does not document update replay idempotency. Type is not mutable.

Agent markdown

monitors.update · Datadog · v1

Details

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

Scopes

None

Input

Input schema
Name	Type	Required	Constraints
`(root)`	`object`	Yes	additionalProperties false; oneOf branch 1: required name / branch 2: required query / branch 3: required name, query / branch 4: required message / branch 5: required name, message / branch 6: required query, message / branch 7: required name, query, message / branch 8: required tags / branch 9: required name, tags / branch 10: required query, tags / branch 11: required name, query, tags / branch 12: required message, tags / branch 13: required name, message, tags / branch 14: required query, message, tags / branch 15: required name, query, message, tags / branch 16: required priority / branch 17: required name, priority / branch 18: required query, priority / branch 19: required name, query, priority / branch 20: required message, priority / branch 21: required name, message, priority / branch 22: required query, message, priority / branch 23: required name, query, message, priority / branch 24: required tags, priority / branch 25: required name, tags, priority / branch 26: required query, tags, priority / branch 27: required name, query, tags, priority / branch 28: required message, tags, priority / branch 29: required name, message, tags, priority / branch 30: required query, message, tags, priority / branch 31: required name, query, message, tags, priority / branch 32: required options / branch 33: required name, options / branch 34: required query, options / branch 35: required name, query, options / branch 36: required message, options / branch 37: required name, message, options / branch 38: required query, message, options / branch 39: required name, query, message, options / branch 40: required tags, options / branch 41: required name, tags, options / branch 42: required query, tags, options / branch 43: required name, query, tags, options / branch 44: required message, tags, options / branch 45: required name, message, tags, options / branch 46: required query, message, tags, options / branch 47: required name, query, message, tags, options / branch 48: required priority, options / branch 49: required name, priority, options / branch 50: required query, priority, options / branch 51: required name, query, priority, options / branch 52: required message, priority, options / branch 53: required name, message, priority, options / branch 54: required query, message, priority, options / branch 55: required name, query, message, priority, options / branch 56: required tags, priority, options / branch 57: required name, tags, priority, options / branch 58: required query, tags, priority, options / branch 59: required name, query, tags, priority, options / branch 60: required message, tags, priority, options / branch 61: required name, message, tags, priority, options / branch 62: required query, message, tags, priority, options / branch 63: required name, query, message, tags, priority, options
`monitor_id`	`integer`	Yes	minimum 1
`name`	`string`	No	minLength 1; maxLength 200
`query`	`string`	No	minLength 1; maxLength 4096
`message`	`string`	No	maxLength 4000
`tags`	`array<string>`	No	maxItems 100
`tags[]`	`string`	Yes	minLength 1; maxLength 200
`priority`	`integer`	No	minimum 1; maximum 5
`options`	`object`	No	additionalProperties false
`options.notify_no_data`	`boolean`	No	—
`options.no_data_timeframe`	`integer`	No	minimum 0; maximum 1440
`options.renotify_interval`	`integer`	No	minimum 0; maximum 10080
`options.evaluation_delay`	`integer`	No	minimum 0; maximum 86400
`options.include_tags`	`boolean`	No	—
`options.require_full_window`	`boolean`	No	—

Output

Output schema
Name	Type	Required	Constraints
`(root)`	`object`	Yes	additionalProperties false
`id`	`integer`	Yes	minimum 1
`name`	`string`	Yes	minLength 1; maxLength 200
`type`	`string`	Yes	minLength 1; maxLength 64
`query`	`string`	Yes	minLength 1; maxLength 4096
`message`	`string`	No	maxLength 4000
`overall_state`	`string`	No	minLength 1; maxLength 64
`creator`	`string`	No	minLength 3; maxLength 320
`created_at`	`string`	No	minLength 1; maxLength 64
`modified_at`	`string`	No	minLength 1; maxLength 64
`tags`	`array<string>`	Yes	maxItems 100
`tags[]`	`string`	Yes	minLength 1; maxLength 200
`priority`	`integer`	No	minimum 1; maximum 5

Raw schema

Input

{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "monitor_id": {
      "type": "integer",
      "minimum": 1
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 4096
    },
    "message": {
      "type": "string",
      "maxLength": 4000
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 200
      },
      "maxItems": 100
    },
    "priority": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5
    },
    "options": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "notify_no_data": {
          "type": "boolean"
        },
        "no_data_timeframe": {
          "type": "integer",
          "minimum": 0,
          "maximum": 1440
        },
        "renotify_interval": {
          "type": "integer",
          "minimum": 0,
          "maximum": 10080
        },
        "evaluation_delay": {
          "type": "integer",
          "minimum": 0,
          "maximum": 86400
        },
        "include_tags": {
          "type": "boolean"
        },
        "require_full_window": {
          "type": "boolean"
        }
      }
    }
  },
  "required": [
    "monitor_id"
  ],
  "oneOf": [
    {
      "required": [
        "name"
      ]
    },
    {
      "required": [
        "query"
      ]
    },
    {
      "required": [
        "name",
        "query"
      ]
    },
    {
      "required": [
        "message"
      ]
    },
    {
      "required": [
        "name",
        "message"
      ]
    },
    {
      "required": [
        "query",
        "message"
      ]
    },
    {
      "required": [
        "name",
        "query",
        "message"
      ]
    },
    {
      "required": [
        "tags"
      ]
    },
    {
      "required": [
        "name",
        "tags"
      ]
    },
    {
      "required": [
        "query",
        "tags"
      ]
    },
    {
      "required": [
        "name",
        "query",
        "tags"
      ]
    },
    {
      "required": [
        "message",
        "tags"
      ]
    },
    {
      "required": [
        "name",
        "message",
        "tags"
      ]
    },
    {
      "required": [
        "query",
        "message",
        "tags"
      ]
    },
    {
      "required": [
        "name",
        "query",
        "message",
        "tags"
      ]
    },
    {
      "required": [
        "priority"
      ]
    },
    {
      "required": [
        "name",
        "priority"
      ]
    },
    {
      "required": [
        "query",
        "priority"
      ]
    },
    {
      "required": [
        "name",
        "query",
        "priority"
      ]
    },
    {
      "required": [
        "message",
        "priority"
      ]
    },
    {
      "required": [
        "name",
        "message",
        "priority"
      ]
    },
    {
      "required": [
        "query",
        "message",
        "priority"
      ]
    },
    {
      "required": [
        "name",
        "query",
        "message",
        "priority"
      ]
    },
    {
      "required": [
        "tags",
        "priority"
      ]
    },
    {
      "required": [
        "name",
        "tags",
        "priority"
      ]
    },
    {
      "required": [
        "query",
        "tags",
        "priority"
      ]
    },
    {
      "required": [
        "name",
        "query",
        "tags",
        "priority"
      ]
    },
    {
      "required": [
        "message",
        "tags",
        "priority"
      ]
    },
    {
      "required": [
        "name",
        "message",
        "tags",
        "priority"
      ]
    },
    {
      "required": [
        "query",
        "message",
        "tags",
        "priority"
      ]
    },
    {
      "required": [
        "name",
        "query",
        "message",
        "tags",
        "priority"
      ]
    },
    {
      "required": [
        "options"
      ]
    },
    {
      "required": [
        "name",
        "options"
      ]
    },
    {
      "required": [
        "query",
        "options"
      ]
    },
    {
      "required": [
        "name",
        "query",
        "options"
      ]
    },
    {
      "required": [
        "message",
        "options"
      ]
    },
    {
      "required": [
        "name",
        "message",
        "options"
      ]
    },
    {
      "required": [
        "query",
        "message",
        "options"
      ]
    },
    {
      "required": [
        "name",
        "query",
        "message",
        "options"
      ]
    },
    {
      "required": [
        "tags",
        "options"
      ]
    },
    {
      "required": [
        "name",
        "tags",
        "options"
      ]
    },
    {
      "required": [
        "query",
        "tags",
        "options"
      ]
    },
    {
      "required": [
        "name",
        "query",
        "tags",
        "options"
      ]
    },
    {
      "required": [
        "message",
        "tags",
        "options"
      ]
    },
    {
      "required": [
        "name",
        "message",
        "tags",
        "options"
      ]
    },
    {
      "required": [
        "query",
        "message",
        "tags",
        "options"
      ]
    },
    {
      "required": [
        "name",
        "query",
        "message",
        "tags",
        "options"
      ]
    },
    {
      "required": [
        "priority",
        "options"
      ]
    },
    {
      "required": [
        "name",
        "priority",
        "options"
      ]
    },
    {
      "required": [
        "query",
        "priority",
        "options"
      ]
    },
    {
      "required": [
        "name",
        "query",
        "priority",
        "options"
      ]
    },
    {
      "required": [
        "message",
        "priority",
        "options"
      ]
    },
    {
      "required": [
        "name",
        "message",
        "priority",
        "options"
      ]
    },
    {
      "required": [
        "query",
        "message",
        "priority",
        "options"
      ]
    },
    {
      "required": [
        "name",
        "query",
        "message",
        "priority",
        "options"
      ]
    },
    {
      "required": [
        "tags",
        "priority",
        "options"
      ]
    },
    {
      "required": [
        "name",
        "tags",
        "priority",
        "options"
      ]
    },
    {
      "required": [
        "query",
        "tags",
        "priority",
        "options"
      ]
    },
    {
      "required": [
        "name",
        "query",
        "tags",
        "priority",
        "options"
      ]
    },
    {
      "required": [
        "message",
        "tags",
        "priority",
        "options"
      ]
    },
    {
      "required": [
        "name",
        "message",
        "tags",
        "priority",
        "options"
      ]
    },
    {
      "required": [
        "query",
        "message",
        "tags",
        "priority",
        "options"
      ]
    },
    {
      "required": [
        "name",
        "query",
        "message",
        "tags",
        "priority",
        "options"
      ]
    }
  ]
}

Output

{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "id": {
      "type": "integer",
      "minimum": 1
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "type": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 4096
    },
    "message": {
      "type": "string",
      "maxLength": 4000
    },
    "overall_state": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "creator": {
      "type": "string",
      "minLength": 3,
      "maxLength": 320
    },
    "created_at": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "modified_at": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 200
      },
      "maxItems": 100
    },
    "priority": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5
    }
  },
  "required": [
    "id",
    "name",
    "type",
    "query",
    "tags"
  ]
}

Update Datadog monitor

Details

Scopes

Input

Output

Raw schema

On this page