v8

latestOpenAPI 3.0.0Apache 2.0raw.githubusercontent.com2025-10-165266542.4 MB
DigitalOcean-public.v2-new_Apps

Update destinations for alerts

Updates the emails and slack webhook destinations for app alerts. Emails must be associated to a user with access to the app.

post/v2/apps/{app_id}/alerts/{alert_id}/destinations

Path parameters

app_idstring required

The app ID

alert_idstring required

The alert ID

Request body

emailsAppAlertEmail[]

Example request

{
  "emails": [
    "sammy@digitalocean.com"
  ],
  "slack_webhooks": [
    {
      "url": "https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX",
      "channel": "Channel Name"
    }
  ]
}

Response

A JSON object with an alert key. This is an object of type alert.

Example response

{
  "alert": {
    "id": "4f6c71e2-1e90-4762-9fee-6cc4a0a9f2cf",
    "component_name": "backend",
    "spec": {
      "rule": "CPU_UTILIZATION",
      "operator": "GREATER_THAN",
      "value": 2.32,
      "window": "FIVE_MINUTES"
    },
    "emails": [
      "sammy@digitalocean.com"
    ],
    "slack_webhooks": [
      {
        "url": "https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX",
        "channel": "Channel Name"
      }
    ],
    "phase": "ACTIVE",
    "progress": {
      "steps": [
        {
          "name": "example_step",
          "status": "SUCCESS",
          "started_at": "2020-11-19T20:27:18Z",
          "ended_at": "2020-11-19T20:27:18Z",
          "reason": {
            "code": "Title of Error",
            "message": "This is an error"
          }
        }
      ]
    }
  }
}