News

Update a curated news article

Updates an existing curated news article. If a new URL is provided and differs from the current one, the article metadata is re-fetched from the URL. Requires edit news permission.

put/api/news/article/{id}

Request

Path parameters

idinteger required

Curated news article identifier

Headers

X-Agent-Namestring
Example:News Agent

Name of the agent making the change, for example News Agent. Recorded as created_by_agent / updated_by_agent only when the request carries an agent token; ignored otherwise. At most 100 characters.

Request body

urlstring url

New article URL (must be unique if changed)

titlestring

Article title

descriptionstring

Article description

imagestring

Image URL for the article. A URL already in the upload bucket is kept as it is; any other value must be a safe, publicly accessible http(s) URL and is copied to the bucket. An empty value clears the image.

published_atstring date-time

Publication date

is_activeboolean

Whether the article is active

tagsinteger[]

Array of news tag IDs to sync

Response

Article updated successfully

idinteger
urlstring
is_activeinteger
reporter_idinteger
titlestring
descriptionstring
imagestring
created_atstring date-time
content_markdownstring
ingestion_request_idstring
updated_atstring date-time
published_atstring date-time

Changes

No recorded changes to this operation across all 2 revisions of this API.