DigitalOcean API (unofficial showcase)
POST/v2/apps/{app_id}/alerts/{alert_id}/destinations

Update destinations for an app alert

Updates the email and Slack webhook destinations for an app alert. Supply destination details in emails, slack_webhooks, or both; each email address must be associated with a user who has access to the app. The response includes the updated alert object.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

2 parameters · 2 body fields
app_idstringrequired
The unique identifier of the app whose alert destinations to update.
alert_idstringrequired
The unique identifier of the alert whose destinations to update.

Alert destination configuration. Include email addresses, Slack webhook details, or both.

emailsarray<string>optional
Email addresses to receive app alerts. Each address must be associated with a user who has access to the app.
slack_webhooksarray<object>optional
Slack webhook destinations for app alerts.

6 status codes
200Returns a JSON object with an `alert` key containing the alert, including its configured email and Slack webhook destinations.
alertobjectoptional
401Returned when authentication fails because the credentials are invalid.
idstringrequired
A short identifier corresponding to the HTTP status code returned. For example, the ID for a response returning a 404 status code would be "not_found."
messagestringrequired
A message providing additional information about the error, including details to help resolve it when possible.
request_idstringoptional
Optionally, some endpoints may include a request ID that should be provided when reporting bugs or opening support tickets to help identify the issue.
404Returned when the requested resource is not found.
idstringrequired
A short identifier corresponding to the HTTP status code returned. For example, the ID for a response returning a 404 status code would be "not_found."
messagestringrequired
A message providing additional information about the error, including details to help resolve it when possible.
request_idstringoptional
Optionally, some endpoints may include a request ID that should be provided when reporting bugs or opening support tickets to help identify the issue.
429Returned when the API rate limit has been exceeded.
idstringrequired
A short identifier corresponding to the HTTP status code returned. For example, the ID for a response returning a 404 status code would be "not_found."
messagestringrequired
A message providing additional information about the error, including details to help resolve it when possible.
request_idstringoptional
Optionally, some endpoints may include a request ID that should be provided when reporting bugs or opening support tickets to help identify the issue.
500Returned when a server error occurs.
idstringrequired
A short identifier corresponding to the HTTP status code returned. For example, the ID for a response returning a 404 status code would be "not_found."
messagestringrequired
A message providing additional information about the error, including details to help resolve it when possible.
request_idstringoptional
Optionally, some endpoints may include a request ID that should be provided when reporting bugs or opening support tickets to help identify the issue.
defaultThere was an unexpected error.
idstringrequired
A short identifier corresponding to the HTTP status code returned. For example, the ID for a response returning a 404 status code would be "not_found."
messagestringrequired
A message providing additional information about the error, including details to help resolve it when possible.
request_idstringoptional
Optionally, some endpoints may include a request ID that should be provided when reporting bugs or opening support tickets to help identify the issue.

Error handling

A 401 is returned when credentials are invalid, and a 404 is returned when the app or alert is not found; the app_id path parameter and alert_id path parameter must identify existing resources. A 429 is returned when the API rate limit is exceeded, and a 500 is returned when a server error occurs. Each email in emails must be associated with a user who has access to the app.