---
title: "Taxonomy"
slug: "taxonomy-1"
updated: 2024-09-20T00:50:15Z
published: 2024-09-20T00:50:15Z
canonical: "help.yahooinc.com/taxonomy-1"
---

> ## 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.

# Taxonomy

## Abstract

Taxonomy helps Yahoo import the hierarchical (or flat) organization of its partners’ data and its associated metadata. Uploading taxonomy is a prerequisite for uploading user/audience data.

> [!WARNING]
> Important
> 
> A partner must maintain a Taxonomy for its entire data set across all segments and attributes for the data that it provides through DataX.

## Methods to Manage Taxonomy

DataX exposes these methods for managing Taxonomy:

1. **POST /taxonomy:** Use this API to create a new version of your Yahoo taxonomy. If successful, the new taxonomy replaces and supercedes the currently active taxonomy.
2. **PUT /taxonomy:** Use this API to send incremental taxonomy data that would be merged with the currently active taxonomy. It supports options to insert, replace, move taxonomy nodes and its sub-tree to an existing taxonomy.
3. **GET /taxonomy:** Use this API to fetch the currently active version. It also supports API to fetch a list of previously uploaded taxonomy metadata.
4. **Delete /taxonomy:** Use this API to delete taxonomy node/s and its sub-tree from currently active taxonomy.

## Topics to Navigate

Explore these topics to better under Taxonomy JSON layouts and methods.

| **Topic** | **Description** |
| --- | --- |
| [Metadata](/datax/docs/metadata-1) | Structure descriptions |
| [Taxonomy Representation](/datax/docs/taxonomy-representation) | Taxonomy JSON layouts |
| [POST /Upload New Taxonomy](/datax/docs/post-taxonomy-upload-new-taxonomy) | Create or refresh taxonomy nodes |
| [PUT /Append Taxonomy Node](/datax/docs/put-append-taxonomy-node) | Update taxonomy data |
| [PUT /Replace Taxonomy Node](/datax/docs/put-replace-taxonomy-node) | Replace existing taxonomy nodes |
| [PUT /Move Node](/datax/docs/put-move-node) | Move existing taxonomy nodes |
| [Delete Taxonomy Node](/datax/docs/delete-taxonomy-node) | Delete existing taxonomy nodes |
| [Get Taxonomy](/datax/docs/get-taxonomy) | Retrieve latest taxonomy version |
| [Error Codes](/datax/docs/error-codes) | Taxonomy errors and descriptions |