# Notification Rule Update

PUT /platform/notification-rules/{rule_id}: Updates a notification rule's name, delivery time, members and enabled. scope and strategy cannot be changed.

Source: https://docs.deepinfo.com/reference/platform/notification-rule-update/

Last updated: 2026-09-27

---
`PUT https://api.deepinfo.com/v1/platform/notification-rules/{rule_id}`

Updates a notification rule's `name`, delivery time, `members` and `enabled`. `scope` and `strategy` cannot be changed.

## Authentication

Send your API key in the `apikey` request header.

## Path Parameters

| Parameter | Required | Description | Example |
|---|---|---|---|
| `rule_id` | Required |  | `000000000000000e8e040001` |

## Request Body

| Parameter | Type | Required | Description |
|---|---|---|---|
| `name` | string | Required | min length `1`; max length `255` |
| `delivery_hour` | integer | Optional | min `0.0`; max `23.0` |
| `delivery_day_of_week` | integer | Optional | min `0.0`; max `6.0` |
| `members` | array | Required | min items `1` |
| `enabled` | boolean | Required |  |

```json
{
  "name": "Critical issues",
  "delivery_hour": 8,
  "members": [
    "00000000-0000-4000-8000-00006bb60001"
  ],
  "enabled": true
}
```

## Response Fields

| Field | Type | Description |
|---|---|---|
| `id` | string |  |
| `name` | string |  |
| `scope` | string | One of `new_issue_detected`, `reappeared_issue_detected`, `asset_security_score_decreased`, `asset_security_score_changed`, `asset_ssl_changed`, `asset_whois_changed`, `asset_dns_changed`, `domain_security_score_decreased`, `domain_security_score_changed`, `new_asset_discovered`, `new_asset_added`, `new_vulnerability_detected`, `reappeared_vulnerability_detected`, `new_email_breach_detected`, `new_suspicious_domain_detected`, `new_fraudulent_domain_detected`, `new_open_port_detected`, `new_employee_credential_detected`, `new_client_credential_detected`, `new_payment_credential_detected`, `new_cybersecurity_news_added` |
| `frequency` | string | One of `instant`, `hourly`, `daily`, `weekly`, `monthly` |
| `delivery_hour` | integer |  |
| `delivery_day_of_week` | integer |  |
| `members` | array of object |  |
| `enabled` | boolean |  |
| `added_date` | string | date-time |
| `last_update_date` | string | date-time |
| `strategy` | object |  |

## Response Schema

_Inferred from examples._ Built from the saved 2xx example response: the fields it contains, with the types seen there. It is not a contract.

| Field | Type |
|---|---|
| `id` | string |
| `name` | string |
| `scope` | string |
| `frequency` | string |
| `delivery_hour` | number |
| `delivery_day_of_week` | null |
| `members` | array<object> |
| `members[].team_member_uuid` | string |
| `members[].email` | string |
| `enabled` | boolean |
| `added_date` | string |
| `last_update_date` | string |
| `strategy` | null |

## Examples

### 200 · OK

```bash
curl -X PUT 'https://api.deepinfo.com/v1/platform/notification-rules/000000000000000e8e040001' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "Critical issues",
  "delivery_hour": 8,
  "members": [
    "00000000-0000-4000-8000-00006bb60001"
  ],
  "enabled": true
}'
```

`Content-Type: application/json` · `deepinfo-request-id: 00000000-0000-4000-8000-0000356d0001`

```json
{
  "id": "000000000000000e8e040001",
  "name": "Critical issues",
  "scope": "new_asset_added",
  "frequency": "daily",
  "delivery_hour": 8,
  "delivery_day_of_week": null,
  "members": [
    {
      "team_member_uuid": "00000000-0000-4000-8000-0000f3aa0001",
      "email": "user@acme.example"
    }
  ],
  "enabled": true,
  "added_date": "2025-06-01T08:00:00Z",
  "last_update_date": "2025-07-01T08:00:00Z",
  "strategy": null
}
```

### 400 · Not Found (nonexistent rule_id)

```bash
curl -X PUT 'https://api.deepinfo.com/v1/platform/notification-rules/ffffffffffffffffffffffff' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{}'
```

`Content-Type: application/json` · `deepinfo-request-id: 00000000-0000-4000-8000-0000356d0001`

```json
{
  "code": 10400,
  "parameters": [
    {
      "param": "name",
      "details": [
        "This field is required."
      ]
    },
    {
      "param": "members",
      "details": [
        "This field is required."
      ]
    }
  ],
  "solution": "https://docs.deepinfo.com/reference/"
}
```