SPsponsorunited
News

Publish a news article

Publishes an article (was 'approve'): status becomes published, it is made active and appears on linked brand/property profiles. Allowed from analysed or unpublished. Only the reporter who submitted the article can publish it.

put/api/news/article/{id}/publish

Request

Path parameters

idinteger required

Response

Article published successfully

idinteger
urlstring
titlestring nullable
descriptionstring nullable
imagestring nullable

Thumbnail URL

status'pending' | 'analysed' | 'published' | 'unpublished' | 'declined' | 'failed'
error_messagestring nullable

Failure reason for a failed submission, sourced from the failed data-ingestion task; null unless status is failed.

is_activeboolean nullable
reporter_idinteger
content_markdownstring nullable
ingestion_request_idstring nullable
logo_idinteger nullable
published_atstring date-time nullable
created_atstring date-time nullable
updated_atstring date-time nullable
contacts_status'needs_review' | 'added' nullable

Rollup of the article's extracted contacts for the queue's Contacts column: added once every extracted person is created, updated or dismissed, needs_review while any still needs a decision, null when the article extracted nobody. Present only on the list endpoint, which carries the counts it is derived from.

assets_added_atstring date-time nullable

When this article's assets were first added through Quick Add. Null until a bulk add names the article.

created_by_agentstring nullable

Name of the agent that created the article, sent in the X-Agent-Name header with an agent token. Null when a person created it.

updated_by_agentstring nullable

Name of the agent that last edited the article through PUT /api/news/article/{id}. Null when the last edit was made by a person, or when the article was never edited.

Example response

{
  "funding": {
    "amount_raised": {
      "raw": "$12.5M",
      "value": 12500000,
      "currency": "USD",
      "usd": 12500000
    },
    "valuation": {
      "raw": "$12.5M",
      "value": 12500000,
      "currency": "USD",
      "usd": 12500000
    }
  }
}

Changes

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