{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"To create an Uptime alert, send a POST request to `/v2/uptime/checks/$CHECK_ID/alerts` specifying the attributes\nin the table below in the JSON body.\n","properties":{"path":{"type":"object","properties":{"check_id":{"type":"string","format":"uuid","examples":["4de7ac8b-495b-4884-9a69-1050c6793cd6"],"description":"A unique identifier for a check."}},"required":["check_id"],"additionalProperties":false},"body":{"type":"object","allOf":[{"$ref":"#/definitions/alert"}],"required":["name","type","notifications","period"]}},"required":["path","body"],"additionalProperties":false,"definitions":{"alert":{"type":"object","allOf":[{"$ref":"#/definitions/alert_base"},{"$ref":"#/definitions/alert_updatable"}]},"alert_base":{"type":"object","properties":{}},"alert_updatable":{"type":"object","properties":{"name":{"type":"string","description":"A human-friendly display name.","examples":["Landing page degraded performance"]},"type":{"type":"string","enum":["latency","down","down_global","ssl_expiry"],"description":"The type of alert.","examples":["latency"]},"threshold":{"type":"integer","description":"The threshold at which the alert will enter a trigger state. The specific threshold is dependent on the alert type.","examples":[300]},"comparison":{"type":"string","description":"The comparison operator used against the alert's threshold.","enum":["greater_than","less_than"],"examples":["greater_than"]},"notifications":{"$ref":"#/definitions/notification"},"period":{"type":"string","description":"Period of time the threshold must be exceeded to trigger the alert.","enum":["2m","3m","5m","10m","15m","30m","1h"],"examples":["2m"]}}},"notification":{"type":"object","description":"The notification settings for a trigger alert.","required":["slack","email"],"properties":{"email":{"description":"An email to notify on an alert trigger. The Email has to be one that is verified on that DigitalOcean account.","type":"array","items":{"type":"string"},"examples":[["bob@example.com"]]},"slack":{"type":"array","description":"Slack integration details.","items":{"type":"object","required":["url","channel"],"properties":{"channel":{"type":"string","description":"Slack channel to notify of an alert trigger.","examples":["Production Alerts"]},"url":{"type":"string","description":"Slack Webhook URL.","examples":["https://hooks.slack.com/services/T1234567/AAAAAAAA/ZZZZZZ"]}}}}}}}},"name":"Create a New Alert","id":"digitalocean.uptime_create_alert","example":{"path":{"check_id":"4de7ac8b-495b-4884-9a69-1050c6793cd6"},"body":{"name":"Landing page degraded performance","type":"latency","notifications":{"slack":[],"email":["bob@example.com"]},"period":"2m"}},"maxRequests":1,"summary":false}}