---
title: "Update Notification"
method: PUT
path: "/organizations/{orgId}/notifications/configurations/{id}"
tags: ["Notifications"]
---

# Update Notification

`PUT /organizations/{orgId}/notifications/configurations/{id}`

Update a Notification with the given UUID.

This endpoint modifies the configuration details of an existing Notification. You can change the Event that triggers the Notification and/or update the conditions for sending the Notification.

## Path parameters

- `orgId` string, required
- `id` string, required

## Request body

- NotificationRequest
  - `version` integer — The version number of the entity: - **Create entity:** Not valid for initial insertion of new entity - *do not use for Create*. On initial Create, version is set at 1 and listed in the response. - **Update Entity:** On Update, version is required and must match the existing version because a check is performed to ensure sequential versioning is preserved. Version is incremented by 1 and listed in the response.

## Response `200`

Returns the updated Notification

- NotificationResponse — Response containing a Notification entity
  - `id` string, required — The UUID of the entity.
  - `version` integer — The version number: - **Create:** On initial Create to insert a new entity, the version is set at 1 in the response. - **Update:** On successful Update, the version is incremented by 1 in the response.
  - `dtCreated` string, date-time — The DateTime when this item was created *(in ISO-8601 format)*.
  - `dtLastModified` string, date-time — The DateTime when this item was last modified *(in ISO-8601 format)*.
  - `createdBy` string — The ID of the user who created this item.
  - `lastModifiedBy` string — The ID of the user who last modified this item.
  - `name` string, required — The name of the Notification.
  - `description` string, required — The description for the Notification providing a brief overview of its purpose and functionality.
  - `active` boolean — A Boolean flag indicating whether or not the Notification is active. * **TRUE** - active Notification. * **FALSE** - inactive Notification.
  - `alwaysFireEvent` boolean — A Boolean flag indicating whether the Notification is always triggered, regardless of other conditions and omitting reference to any calculation. This means the Notification will be triggered simply by the Event it is based on occurring and with no further conditions having to be met. * **TRUE** - the Notification is always triggered and omits any reference to the calculation to check for other conditions being true before triggering the Notification. * **FALSE** - the Notification is only triggered when the Event it is based on occurs and any calculation is checked and all conditions defined by the calculation are met.
  - `eventName` string — The name of the Event that the Notification is based on. When this Event occurs and the calculation evaluates to `True`, the Notification is triggered. **Note:** If the Notification is set to always fire, then the Notification will always be sent when the Event it is based on occurs, and without any other conditions defined by a calculation having to be met.
  - `calculation` string — A logical expression that that is evaluated to a Boolean. If it evaluates as `True`, a Notification for the Event is created and sent to the configured destination. Calculations can reference numeric, string, and boolean Event fields. See [Creating Calculations](https://www.m3ter.com/docs/guides/utilizing-events-and-notifications/key-concepts-and-relationships#creating-calculations) in the m3ter documentation for more information.
  - `code` string, required — The short code for the Notification.

## Other responses

- `4XX` — Error message
- `5XX` — Error message

---

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