Update a notification configuration

PATCH

https://api.modulards.com/api/public/v1/alerts/:alert_id

PATCH

/api/public/v1/alerts/:alert_id

curl -X PATCH https://api.modulards.com/api/public/v1/alerts/alert_id \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "status": "disabled"
}'

200Update a notification configuration

{
  "data": {
    "attributes": {
      "created_at": "2026-09-20T09:00:00.000000Z",
      "discord_channel": false,
      "email_channel": true,
      "is_default": false,
      "name": "Operations",
      "slack_channel": false,
      "status": "enabled",
      "updated_at": "2026-09-28T09:05:00.000000Z",
      "whatsapp_channel": false
    },
    "id": "12",
    "links": {
      "self": "https://api.modulards.com/api/public/v1/alerts/12"
    },
    "type": "alerts"
  },
  "jsonapi": {
    "version": "1.1"
  }
}

Changes what you send on a notification configuration and leaves the rest as it is: fields you leave out, and events you do not list in items, keep their stored value. Send only the fields you want to change.

Body

All fields are optional and take the same values as in “Create a notification configuration”.

name (string, optional): at most 30 characters.
default (boolean, optional): whether it is the organization’s default configuration.
status (enabled or disabled, optional): whether the configuration is active.
email_channel, whatsapp_channel, slack_channel, discord_channel (boolean, optional): which channels are active. WhatsApp, Slack and Discord depend on the organization’s plan, as in “Create a notification configuration”.
items (array, optional): entries of {type, status} for the events you want to change.

Authentication

AuthorizationBearer

Personal access token created in the Modular DS dashboard; read-only tokens can only call GET endpoints.

Path parameters

alert_idstringRequired

Request

This endpoint expects an object.

statusstringOptional

Response

200 - Configuration

dataobjectOptional

jsonapiobjectOptional