---
title: "Update Notification Policy"
method: PUT
path: "/notification_policies/{notification_policy_id}"
tags: ["Portfolio Monitoring"]
---

# Update Notification Policy

`PUT /notification_policies/{notification_policy_id}`

Update a notification policy by ID.

## Path parameters

- `notification_policy_id` string, uuid, required

## Request body

- V1UpdateNotificationPolicyRequest — Request model for updating a notification policy.
  - `name` string, nullable — The name of the notification policy.
  - `enabled` boolean, nullable — Whether the notification policy should be enabled.
  - `cadence` 'daily' | 'weekly' | 'biweekly' | 'monthly' | 'quarterly' | 'biannually' | 'annually' — The cadence of monitoring.
  - `attributes` V1NotifiableAttributes[], nullable — List of attributes to notify on (officers, alternative_names).
  - `recipients` string[], nullable — List of email recipients for email notification policies.

## Response `200`

Response

- V1NotificationPolicyResponse — Represents a notification policy response.
  - `id` string, uuid, required — The unique identifier of the notification policy.
  - `type` string, required — The type of notification policy (email, slack, webhook).
  - `name` string, required — The name of the notification policy.
  - `group_id` string, uuid, nullable — The unique identifier of the portfolio group (if applicable).
  - `item_id` string, uuid, nullable — The unique identifier of the portfolio item (if applicable).
  - `enabled` boolean, required — Whether the notification policy is enabled.
  - `cadence` 'daily' | 'weekly' | 'biweekly' | 'monthly' | 'quarterly' | 'biannually' | 'annually', required — The cadence of monitoring.
  - `last_run_at` string, date-time, nullable — When the notification policy was last executed.
  - `next_run_on` string, date, nullable — When the notification policy is scheduled to run next.
  - `attributes` V1NotifiableAttributes[] — List of attributes to notify on (officers, alternative_names).
  - `recipients` string[] — List of email recipients for email notification policies.
  - `created_at` string, date-time, required — When the notification policy was created.
  - `updated_at` string, date-time, nullable — When the notification policy was last updated.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/baselayer/apis/baselayer-api-service.md) · [All operations](https://skmtc.net/baselayer/apis/baselayer-api-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/baselayer/baselayer-api-service/versions/0cc89938bc26/schema)