---
title: "Put Notification Element"
method: PUT
path: "/notifications/{id}/elements/{elementId}"
tags: ["Templates"]
---

# Put Notification Element

`PUT /notifications/{id}/elements/{elementId}`

Replaces one Elemental element in a template, addressed by its element id. Supported for V2 templates only, not V1 blocks and channels.

## Path parameters

- `id` string, required
- `elementId` string, required

## Request body

- NotificationElementPutRequest — Request body for updating a single element. Additional type-specific fields are allowed.
  - `type` string, required — Element type (text, meta, action, image, etc.).
  - `channels` string[]
  - `data` object
  - `if` string
  - `loop` string
  - `ref` string
  - `state` 'DRAFT' | 'PUBLISHED' — Template state. Defaults to `DRAFT`.

## Response `200`

Element updated.

- NotificationContentMutationResponse — Shared mutation response for `PUT` content, `PUT` element, and `PUT` locale operations. Contains the template ID, content version, per-element checksums, and resulting state.
  - `id` string, required — Template ID.
  - `version` string, required — Content version identifier.
  - `elements` object[], required
    - `id` string, required
    - `checksum` string, required
  - `state` 'DRAFT' | 'PUBLISHED', required — Template state. Defaults to `DRAFT`.

## Other responses

- `400` — Bad Request
- `404` — Not Found

---

[API](https://skmtc.net/trycourier/apis/courier.md) · [All operations](https://skmtc.net/trycourier/apis/courier/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/trycourier/courier/versions/04f69fbf96a5/schema)