PUT /taxonomy/replace/<taxo-id> – Replace taxonomy node

Use this function to replace existing taxonomy node and its sub-tree with a new taxonomy data.

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 - Replace node

PUT /v1/taxonomy/replace/YR2000
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" : "Replace node 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",
        "subTaxonomy" : [
                {
                        "id" : "YR2100",
                        "name" : "Baby Toy cars", "type" : "SEGMENT"
                }
        ]
}
--xyz—