Update a Filter List¶
Change the information of an existing filter list.
Endpoint¶
PATCH https://api.crowdynews.com/collection/lists/{id}
Request Parameters¶
HEADER FIELD | VALUE DESCRIPTION |
---|---|
Content-Type | The content type of the request body, must be set to application/json . |
URL PARAMETER | VALUE DESCRIPTION |
---|---|
id | The resource ID of the list. The consumer that wants to update the list must have access to the contract said list belongs to, otherwise this action is forbidden. |
QUERY PARAMETER | VALUE DESCRIPTION |
---|---|
access_token | A valid OAuth access token with the correct permission(s). |
REQUEST BODY DATA | VALUE TYPE | VALUE DESCRIPTION |
---|---|---|
name | String | Optional. Identifies the list in a human readable way and must be unique inside a contract. |
entries | Array | Optional. Contains rule values. Depending on the list type, the entries are either plain strings or string patterns. |
active | Boolean | Optional. Specifies if this collection will be processed by the platform. |
Response Format¶
On success, the HTTP status code in the response header is
200 OK
and the response body will contain a list
Object in JSON format. On error, the header status code is
an error code
and the response body contains an error object.
Example Request¶
Request:
PATCH https://api.crowdynews.com/collection/lists/565d4de40d6f659557f64356?access_token={your access token}
{
"entries": [
"/shi+t*/i"
]
}
Response:
HTTP/1.1 201
{
"_id": "565d4de40d6f659557f64356",
"created": "2016-03-22T15:01:49.081Z",
"createdBy": "John Doe",
"lastModified": "2016-03-22T15:01:49.081Z",
"lastModifiedBy": "John Doe",
"active": true,
"contractId": "565c4df4056e859526e62257",
"name": "My Profanity Pattern List",
"type": "patterns",
"entries": [
"/shi+t*/i"
]
}