---
title: "PUT /Replace Taxonomy Node"
slug: "put-replace-taxonomy-node"
updated: 2024-03-15T17:49:31Z
published: 2024-03-15T17:49:31Z
canonical: "help.yahooinc.com/put-replace-taxonomy-node"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.yahooinc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PUT /Replace Taxonomy Node

# 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

```plaintext
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—
```