{
  "opencollection": "1.0.0",
  "info": {
    "name": "Datadog Account Monitors API",
    "version": "1.0"
  },
  "request": {
    "auth": {
      "type": "apikey",
      "key": "DD-API-KEY",
      "value": "{{DD-API-KEY}}",
      "placement": "header"
    }
  },
  "items": [
    {
      "info": {
        "name": "Monitors",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Datadog List All Monitors",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://{subdomain}.{site}/api/v1/monitor",
            "params": [
              {
                "name": "group_states",
                "value": "example_value",
                "type": "query",
                "description": "Comma-separated list of group states to filter monitors by (alert, ignored, no data, ok, skipped, unknown, warn)"
              },
              {
                "name": "name",
                "value": "Example Monitor",
                "type": "query",
                "description": "Filter monitors by name substring match"
              },
              {
                "name": "tags",
                "value": "env:production",
                "type": "query",
                "description": "Comma-separated list of tags to filter monitors by"
              },
              {
                "name": "monitor_tags",
                "value": "env:production",
                "type": "query",
                "description": "Comma-separated list of monitor-specific tags to filter by"
              },
              {
                "name": "with_downtimes",
                "value": "true",
                "type": "query",
                "description": "When true, includes downtime information in the response"
              },
              {
                "name": "id_offset",
                "value": "42",
                "type": "query",
                "description": "Monitor ID to start paginating from (for cursor-based pagination)"
              },
              {
                "name": "page",
                "value": "42",
                "type": "query",
                "description": "The page number to retrieve (zero-indexed, for offset-based pagination)"
              },
              {
                "name": "page_size",
                "value": "42",
                "type": "query",
                "description": "The number of monitors to return per page (default 100, max 1000)"
              }
            ]
          },
          "docs": "Returns a paginated list of monitors for your Datadog organization. Results can be filtered by monitor type, group states, name tags, monitor tags, creator, and ID. Supports sorting by name, status, and type. Use this endpoint to audit your monitoring configuration or build monitoring dashboards."
        },
        {
          "info": {
            "name": "Datadog Create a Monitor",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://{subdomain}.{site}/api/v1/monitor",
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Creates a new monitor with the specified configuration. The monitor type determines which query language and threshold options are available. Monitors can alert on metric thresholds, anomalies, log patterns, APM traces, synthetic test results, and more. Upon creation, Datadog begins evaluating the monitor against the defined query and will send notifications when alert conditions are met."
        },
        {
          "info": {
            "name": "Datadog Get a Monitor",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://{subdomain}.{site}/api/v1/monitor/:monitor_id",
            "params": [
              {
                "name": "monitor_id",
                "value": "",
                "type": "path",
                "description": "The unique numeric ID of the monitor to operate on"
              },
              {
                "name": "group_states",
                "value": "example_value",
                "type": "query",
                "description": "Comma-separated group states to include in the response (alert, ignored, no data, ok, skipped, unknown, warn)"
              },
              {
                "name": "with_downtimes",
                "value": "true",
                "type": "query",
                "description": "When true, includes active downtime information in the response"
              }
            ]
          },
          "docs": "Returns the configuration and current status of a specific monitor identified by its ID. Includes the monitor query, notification settings, alert thresholds, and current group statuses. Optionally includes downtime and creator information."
        },
        {
          "info": {
            "name": "Datadog Edit a Monitor",
            "type": "http"
          },
          "http": {
            "method": "PUT",
            "url": "https://{subdomain}.{site}/api/v1/monitor/:monitor_id",
            "params": [
              {
                "name": "monitor_id",
                "value": "",
                "type": "path",
                "description": "The unique numeric ID of the monitor to operate on"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Updates the configuration of an existing monitor identified by its ID. The request body replaces the entire monitor configuration, so include all desired fields in the update. Changes to the query or thresholds take effect immediately. Updating notification channels or message templates applies to future alerts."
        },
        {
          "info": {
            "name": "Datadog Delete a Monitor",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://{subdomain}.{site}/api/v1/monitor/:monitor_id",
            "params": [
              {
                "name": "monitor_id",
                "value": "",
                "type": "path",
                "description": "The unique numeric ID of the monitor to operate on"
              },
              {
                "name": "force",
                "value": "example_value",
                "type": "query",
                "description": "When true, forcefully deletes the monitor even if it is referenced by SLOs or composite monitors"
              }
            ]
          },
          "docs": "Permanently deletes the monitor with the specified ID. Deletion cannot be undone. Active alerts and notifications for the monitor are immediately cancelled. Any associated SLOs referencing this monitor must be updated before the monitor can be deleted."
        }
      ]
    }
  ],
  "bundled": true
}