News

Create a curated news article

Creates a new curated news article with associated companies, agencies, teams, and tags. Requires news administration permission.

post/api/news/article

Request

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 required

Article URL. Must be unique among usable articles: a URL left behind by a failed article is accepted (that article is purged), while one belonging to a declined article is rejected until it is restored or deleted.

titlestring required

Article title

descriptionstring required

Article description

imagestring nullable

Image URL for the article. Absent, null or empty: the article is created without a logo (logo_id stays null); no logo is resolved from the article URL.

published_atstring date-time

Publication date (defaults to now)

is_sponsorshipboolean
tagsinteger[]

Array of news tag IDs

Response

Article created 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.