--- title: "Decline a news article" method: PUT path: "/api/news/article/{id}/decline" tags: ["News"] --- # Decline a news article `PUT /api/news/article/{id}/decline` ## Request - Base URL: `https://api.sponsorunited.com` (the document declares no server; this is the origin it was published from) - URL: `https://api.sponsorunited.com/api/news/article/{id}/decline` - Auth: HTTP bearer - TypeScript: (a function with typed inputs; its response is checked against the schema) 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. ## Path parameters - `id` integer, required ## Response `200` Article declined successfully - NewsSubmissionResource - `id` integer - `url` string - `title` string, nullable - `description` string, nullable - `image` string, nullable: Thumbnail URL - `status` 'pending' | 'analysed' | 'published' | 'unpublished' | 'declined' | 'failed' - `error_message` string, nullable: Failure reason for a failed submission, sourced from the failed data-ingestion task; null unless status is failed. - `is_active` boolean, nullable - `reporter_id` integer - `submitted_by` object, nullable: The user who submitted the article (sourced from reporter_id). Present when the reporter relation is loaded. - `id` integer - `name` string - `content_markdown` string, nullable - `ingestion_request_id` string, nullable - `logo_id` integer, nullable - `published_at` string, date-time, nullable - `created_at` string, date-time, nullable - `updated_at` string, 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_at` string, date-time, nullable: When this article's assets were first added through Quick Add. Null until a bulk add names the article. - `created_by_agent` string, 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_agent` string, 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. - `companies` object[] - `id` integer - `name` string - `approved` boolean - `created_by_agent` string, nullable: Name of the agent that added this link. Null when a person or the extraction added it. - `properties` object[] - `id` integer - `name` string - `league_id` integer - `created_by_agent` string, nullable: Name of the agent that added this link. Null when a person or the extraction added it. - `agencies` object[] - `id` integer - `name` string - `created_by_agent` string, nullable: Name of the agent that added this link. Null when a person or the extraction added it. - `tags` object[] - `id` integer - `name` string - `created_by_agent` string, nullable: Name of the agent that added this tag. Null when a person added it. - `funding` object, nullable: Structured funding data for the article, backing the New Funding tab's columns. Null when the article has no funding record — the same shape on the list and show endpoints. - `source` 'submitted' | 'extracted' - `company` string, nullable - `website` string, nullable - `amount_raised` NewsSubmissionFundingMoney: One money figure: as written in the article, parsed in its original currency, and normalized to USD by the submitter. Display `raw`, sort on `usd`. All four are null when the article discloses no figure — not every round discloses a valuation. - `raw` string, nullable - `value` number, float, nullable - `currency` string, nullable - `usd` number, float, nullable - `valuation` NewsSubmissionFundingMoney: One money figure: as written in the article, parsed in its original currency, and normalized to USD by the submitter. Display `raw`, sort on `usd`. All four are null when the article discloses no figure — not every round discloses a valuation. - `raw` string, nullable - `value` number, float, nullable - `currency` string, nullable - `usd` number, float, nullable - `funding_round` 'seed' | 'series_a' | 'series_b' | 'series_c' | 'series_d' | 'series_e' | 'other', nullable - `funding_round_label` string, nullable: The round exactly as reported, present only when funding_round is `other`. - `sector` string, nullable: Business sector, for example Fintech. Not a geography — `markets` means geography elsewhere in this API. - `investors` string[]: Investor names, in the order they were recorded. - `extracted_contacts` NewsContactResource[]: People extracted from the article, ordered by extraction confidence DESC. Present only on the show endpoint. - `id` integer: One extracted person, in the shape the article payload has always used. The submission payload renders every row through this and the single-contact routes render one, so a reviewer editing a contact reads back exactly the shape the article page will show them (OP-1514, OP-1515). - `name` string - `title` string, nullable - `company` string, nullable - `role_context` string, nullable - `confidence` number, float - `source` 'extracted' | 'submitted': Whether the row came from the article's own extraction or arrived with the submission. - `submitted_linkedin_url` string, nullable: A LinkedIn profile supplied with the submission. Distinct from the `add.linkedin_url` the sourcing agent finds. - `match` NewsExtractionMatch: Entity-mapping resolver verdict for one extracted person (OP-966/967/968). - `status` 'pending' | 'auto_match' | 'needs_review' | 'no_match' - `confidence` number, float, nullable - `resolved_at` string, date-time, nullable - `person_profile_id` integer, nullable - `contact_id` integer, nullable - `contactable_type` 'agency' | 'brand' | 'property', nullable: Morph alias of the resolved entity; pairs with contactable_id to open the Administration Contacts context. - `contactable_id` integer, nullable - `entity_name` string, nullable: Name of the resolved agency / brand / property. - `candidates` object[]: Resolver top-K candidates; empty when the row was never resolved. - `current` NewsExtractionMatchedContact, nullable: Present-day platform values of the matched contact, for side-by-side comparison against the extracted ones. Null when the extraction resolved to no contact. - `id` integer - `name` string, nullable - `email` string, nullable - `position` string, nullable - `linkedin` string, nullable - `add` NewsExtractionAdd: Outcome of adding this extracted person to the platform. Contacts only — a quote becomes a note on a contact, never a contact of its own. `not_added` is the only selectable state; `needs_review` means the sourcing agent found profiles but could not choose between them. - `status` 'not_added' | 'processing' | 'needs_review' | 'created' | 'updated' | 'failed' - `added_at` string, date-time, nullable: When the reviewer clicked Add contacts selected. - `contact_id` integer, nullable: The platform contact this row produced. - `error` string, nullable: Readable failure reason when status is failed. - `linkedin_url` string, nullable: The profile in play for this row: the one it was created from when status is created, or the one last tried when status is processing or failed. With `candidates` still populated, a failed row can offer the same pick again instead of re-running the search. - `candidates` object[]: Profiles the agent found but could not choose between. Present when status is needs_review; the reviewer picks one and posts it to the resolve endpoint. - `slug` string - `linkedin_url` string - `title` string - `snippet` string - `position` integer - `extracted_quotes` object[]: Quotes extracted from the article, ordered by extraction confidence DESC. Present only on the show endpoint. - `id` integer - `name` string - `title` string, nullable - `company` string, nullable - `context` string, nullable - `confidence` number, float - `quote_text` string - `quote_type` string - `match` NewsExtractionMatch: Entity-mapping resolver verdict for one extracted person (OP-966/967/968). - `status` 'pending' | 'auto_match' | 'needs_review' | 'no_match' - `confidence` number, float, nullable - `resolved_at` string, date-time, nullable - `person_profile_id` integer, nullable - `contact_id` integer, nullable - `contactable_type` 'agency' | 'brand' | 'property', nullable: Morph alias of the resolved entity; pairs with contactable_id to open the Administration Contacts context. - `contactable_id` integer, nullable - `entity_name` string, nullable: Name of the resolved agency / brand / property. - `candidates` object[]: Resolver top-K candidates; empty when the row was never resolved. - `current` NewsExtractionMatchedContact, nullable: Present-day platform values of the matched contact, for side-by-side comparison against the extracted ones. Null when the extraction resolved to no contact. - `id` integer - `name` string, nullable - `email` string, nullable - `position` string, nullable - `linkedin` string, nullable - `extracted_assets` object[]: Assets extracted from the article (dismissed rows excluded), ordered by extraction confidence DESC. Present only on the show endpoint. - `id` integer - `suggested_name` string - `confidence` number, float - `match_status` 'pending' | 'auto_match' | 'needs_review' | 'no_match' | 'confirmed' - `source` 'extracted' | 'manual' - `context` string, nullable - `item` object, nullable: Canonical catalog row when the asset has been resolved (auto_match/confirmed). - `id` integer - `name` string, nullable - `description` string, nullable - `item_platform_id` integer - `item_subplatform_id` integer ## Other responses - `403`: Forbidden — missing view-news permission - `404`: Article not found - `422`: Transition not allowed from the current status --- [API](https://skmtc.dev/sponsorunited/apis/sponsorunited-api.md) - [All operations](https://skmtc.dev/sponsorunited/apis/sponsorunited-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sponsorunited/apis/sponsorunited-api/revisions/cbf1ca5bff8f?raw)