9007: Remove content

Remove a tagged content item. Individual content items may be removed from the system, when they can be uniquely matched on tags and data.

Endpoint ID:

9007

Method:

URL:

/content/tagged/remove

Request body:

A JSON object describing the content-matching query parameters.

Required fields:

tags

An array of tags. All of the content tags must be matched.

Unlike Search, where content is matched as long as it contains all of the query tags, content may only be removed when all of the query tags match all of the content tags. So if we have a content item with tags [ "tag1, "tag2", "tag3" ]:

Query tags	Search	Remove
[ "tag2" ]
[ "tag1", "tag2" ]
[ "tag1, "tag2", "tag3" ]

data

A dictionary of strings or decimal values. Every dictionary item must be matched.

Every query data item must match a data item in the content that is to be removed. However not all content data items must be included in the query data.

So a query containing:

"data": { "uniqueKey": 97531 }

would match content with:

"data": { "uniqueKey": 97531, "weekday": "Tuesday", "weekOfYear": 32 }

Example 1

{
   "tags": [ "t1", "t2" ],
   "data": {
      "uniqueKey": 97531
   }
}

Example 2

 {
   "tags": [ "schedule" ],
   "data": {
      "weekDay": "Tuesday",
      "weekInYear": 32
   }
}

Response body:

None

Status codes: 204 Content was successfully removed

400.1 Remove failed - multiple content items matched

404.4 Content not found