PUT /taxonomy/append/[<parent-id>] – Append to existing taxonomy node

Use this function to update taxonomy for the data that you share with Yahoo This API should be used to append node and its sub-tree to an existing taxonomy node, represented by parent-id. Taxonomy nodes will be inserted to the top of the hierarchy if parent-id is not specified.

The API will usually return a 202 Accepted response with updated metadata in its response. An API caller can fetch metadata’s “self” link to check for status updates.

Example - Append Taxonomy Data

PUT /v1/taxonomy/append/YR1194 HTTP/1.1 Host: datax.yahooapis.com
Content-Type: multipart/form-data;boundary=xyz

--xyz
Content-Disposition: form-data; name="metadata" Content-Type: application/json;charset=UTF-8

{ "description" : "Incremental data for YaRetail Pilot Taxonomy v1" }

--xyz
Content-Disposition: form-data; name="data" Content-Type: application/json;charset=UTF-8

[
        {
                "id" : "YR2000",
                "name" : "Baby Toys",
                "type" : "SEGMENT"
        }
]
--xyz—

Example - Successful Response

HTTP/1.1 202 Accepted
Content-Type: application/json;charset=UTF-8 Date: Tue, 12 Aug 2014 10:00:32 GMT

{
        "resourceType" : "datax-taxonomy",
        "resourceId" : "140812T010009Z662599033", "createTime" : "2014-08-12T10:00:32Z",
        "description" : "Incremental data for YaRetail Pilot Taxonomy v1",
        "links" : [{
                "rel"   : "self",
                "href" : "https://datax.yahooapis.com/v1/link/s/rzP5sfj7EJV-"
        },{
                "rel"   : "describes",
                "href" : "https://datax.yahooapis.com/v1/link/qd5fdsr9akhaO-"
        }],
        "status" : {
                "state" : "PROCESSING",
                "lastUpdateTime" : "2014-08-12T10:00:32Z"
        }
}