PATCH/application_groups/:application_group_name/notifications
Optional Parameters
application_group_nameName of the application group
alertsArray of alert configuration objects
Updates alert settings for an application group.
Configures notification alerts for all stacks within the specified application group. This allows bulk management of alert settings across multiple related stacks.
Alert Configuration
Each alert configuration requires:
- alert_name: The name of the alert to configure
- subscriptions: Array of notification channel configurations
Supported Channels
- email: Basic email notifications
- slack: Requires
slack_urlparameter with Slack webhook URL - webhook: Requires
webhook_urlparameter with your webhook endpoint - browser: In-browser notifications
Response Structure
The response contains three categories:
- successes: Alerts successfully configured
- not_applicable: Alerts that don't apply to stacks in this group
- failures: Alerts that failed to configure
Alert configurations applied to an application group will affect all stacks within that group. Individual stack alert settings may override application group settings.
Response Status Codes
| Status Code | Description |
|---|---|
| 200 | Success - Alerts updated for all stacks in the application group |
| 400 | Bad Request - Invalid alert configuration provided |
| 401 | Unauthorized - Authentication failed or missing OAuth token |
| 403 | Forbidden - OAuth token lacks required `admin` scope or insufficient permissions |
| 404 | Not Found - Application group not found |
Request
PATCH
/application_groups/:application_group_name/notificationscurl -X PATCH \
"https://app.cloud66.com/api/3/application_groups/:application_group_name/notifications" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"Response
{
"successes": {
"alerts": [
"deployment_failed"
],
"count": 1
},
"not_applicable": {
"alerts": [],
"count": 0
},
"failures": {
"alerts": [],
"count": 0
}
}