---
title: "Update a news article."
method: PUT
path: "/engagement/news/{newsId}"
tags: ["Engagement News"]
---

# Update a news article.

`PUT /engagement/news/{newsId}`

## Request

- Base URL: `https://api.gleap.io/v3`
- URL: `https://api.gleap.io/v3/engagement/news/{newsId}`
- Auth: HTTP bearer

Update an engagement news article. Any pending (not yet sent) deliveries for this engagement are discarded
and re-queued from the updated document. While an engagement is live, its audience, targeting and
scheduling fields cannot be changed (for `fixed` frequency engagements neither can its content); pause
it first or the request fails with 409. Setting `status` to `live` starts delivery. `type`, `project`,
`organisation` and `createdBy` are set server-side and ignored if supplied. `searchContent` is derived
from `subject` (recomputed only when `subject` is sent) and ignored if supplied. News items always use a
dynamic audience, so `frequencyType: "fixed"` and `csvContacts` are ignored unless the item already
stores them.

## Path parameters

- `newsId` string, required

## Headers

- `project` string, required

## Request body

- unknown

## Response `200`

Ok

- unknown

## Changes

- **2026-10-08** `fd83cd1963c4`: 1 info
  - removed `#/components/schemas/Document_any.any.any_, subschema #1, subschema #3` from the response body `allOf` list for the response status `200`
- **2026-10-08** `d12d5ab961e5`: 6 info
  - added the optional property `allOf[subschema #1]/commentEmailOptOuts` to the response with the `200` status
  - added the optional property `allOf[subschema #1]/emailCategory` to the response with the `200` status
  - added the optional property `allOf[subschema #1]/emailStyle` to the response with the `200` status
  - added the optional property `allOf[subschema #1]/kai` to the response with the `200` status
  - …2 more
- **2026-09-18** `55f99ebe7b16`: 2 info
  - added the optional property `allOf[subschema #1]/aiSummaryAttemptedAt` to the response with the `200` status
  - added the optional property `allOf[subschema #1]/aiSummaryData` to the response with the `200` status
- **2026-08-04** `9e2491ede559`: 1 info
  - added the optional property `allOf[subschema #1]/slug` to the response with the `200` status

[Operation history](https://skmtc.dev/gleap/apis/gleap-server/changes/engagement/news/:newsId/put.md)

---

[API](https://skmtc.dev/gleap/apis/gleap-server.md) - [All operations](https://skmtc.dev/gleap/apis/gleap-server/llms.txt) - [OpenAPI document](https://skmtc.dev/gleap/apis/gleap-server/revisions/3b025e883cef?raw)