SPsponsorunited
News

Link brands, agencies, properties or tags to a news article without replacing the list

Adds the given ids to one link list of the article. Ids already linked stay linked, and nothing already on the list is removed — unlike the article PUT, which replaces the whole list.

post/api/news/article/{id}/links

Request

Path parameters

idinteger required

Curated news article id

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

type'company' | 'agency' | 'property' | 'tag' required

Which link list to add to. company is a brand; property is a team/property.

idsinteger[] required

Ids to link. Ids already linked are left as they are; nothing already linked is removed.

Example request

{
  "type": "company",
  "ids": [
    481
  ]
}

Response

The link list after the change.

idinteger

Curated news article id

type'company' | 'agency' | 'property' | 'tag'
linked_idsinteger[]

Every id of this type linked to the article after the change, ascending.

Example response

{
  "id": 42,
  "type": "company",
  "linked_ids": [
    481
  ]
}

Changes

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