News

Decline a news article

Declines an article (was 'reject'): a recoverable soft-delete that removes it from the active queue. It remains in the Declined list and can be restored. Allowed from analysed, unpublished or published. Only the reporter who submitted the article can decline it.

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

Request

Path parameters

idinteger required

Response

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