removeCategoryFromLink¶
Request Method: PUT
Description: Removes the specified attached Category from a link
URL: https://api.iovox.com:444/Links?v=3&method=removeCategoryFromLink
The following parameters can be sent in the querystring
| Parameter | Description | Default Value | Data Type | Mandatory |
| v | API version to use | INTEGER | YES |
Payload¶
The following XML payload must be sent with an removeCategoryFromLink request:
<?xml version="1.0" encoding="utf-8"?>
<request>
<link>
<link_id>333</link_id>
<category_id>123</category_id>
<label>Business Category</label>
</link>
<link>
<link_id>333</link_id>
<category_id>124</category_id>
<label>Customer Type</label>
</link>
<link>
<link_id>444</link_id>
<category_id>230</category_id>
<label>Location</label>
</link>
</request>
Payload Description¶
| Node Name | Description | Default Value | Data Type | Mandatory |
| link_id | The Link ID to remove the category from | STRING | YES | |
| category_id | The ID of the category to be removed. Retrievable by the Categories method getCategoryID | STRING | YES | |
| label | The label of the category to be removed | STRING | YES |
Result¶
Error Result¶
| HTTP Code | Error String | Resolution |
| 400 | API Version Empty | Add a value for the v parameter in the query string |
| 400 | API Version Invalid | Correct v parameter |
| 400 | Request Method must be PUT. x attempted | Switch request method x to PUT |
| 400 | XML Empty | Add xml to the request body |
| 400 | XML parse error. x at line y, column z | Correct XML at point x on line y, column z |
| 400 | Request Empty | Add at least one link_id to the request |
| 400 | Link ID x of y Empty | Correct link_id x (item) of y (total) |
| 400 | Link ID x of y does not exist | Correct link_id x (item) of y (total) |
| 400 | Category ID x of y Empty | Add category_id x (item) of y (total) |
| 400 | Category ID x of y not an integer | Correct category_id x (item) of y (total) |
| 400 | Label x of y Empty | Correct label x (item) of y (total) |
| 400 | Category ID/Label Combination x of y does not exist | Correct category_id and label combination x (item) of y (total) |
| 400 | Category ID/Label Combination x of y not attached to Link ID z | Correct or remove category_id and label combination x (item) of y (total) |
| 500 | Internal Server Error | Retry later |