# Content Management APIs for Taxonomy

### About this export

| Field | Value |
| --- | --- |
| **content_type** | lesson |
| **platform** | contentstack-academy |
| **source_url** | https://www.contentstack.com/academy/courses/taxonomy-foundations/content-management-apis-for-taxonomy |
| **course_slug** | taxonomy-foundations |
| **lesson_slug** | content-management-apis-for-taxonomy |
| **markdown_file_url** | /academy/md/courses/taxonomy-foundations/content-management-apis-for-taxonomy.md |
| **generated_at** | 2026-04-28T06:55:49.306Z |

> Part of **[Taxonomy Foundations](https://www.contentstack.com/academy/courses/taxonomy-foundations)** on Contentstack Academy. **Academy MD v3** — structured for retrieval; no quiz or assessment keys.

<!-- ai_metadata: {"lesson_id":"18","type":"text","duration_minutes":1,"topics":["Content","Management","APIs","for","Taxonomy"]} -->

#### Lesson text

Let's consider an example. Our stack has the following taxonomy created.

We have terms inside **Superhero**, as seen in the image below.

![cm1.png](https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blta2c07a004b22deaf/66491a5c52619de069a90a7a/cm1.png)

## **Get all taxonomies**

The Get All Taxonomies request provides detailed information about every taxonomy available within your company's specific stack.

**Example**: Let's retrieve every taxonomy found within our stack. Take into consideration the example given in the Overview section.

Below is the curl command for the same. 

curl --location 'https://api.contentstack.io/v3/taxonomies' \\  
  
\--header 'api\_key: \*\*\*\*\*\*\*\*\*\*\*\*\*\*' \\  
  
\--header 'authorization: \*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*' \\  
  
\--header 'Content-Type: application/json' \\  
  
 --data ''

View the screenshot below to view the outcome of the postman call.

![cm2.png](https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blte56d3a57b7d08f32/66491abb5c2483ea33bc3490/cm2.png)

## **Get a single taxonomy**

The "Get a single taxonomy" request provides detailed information about a single taxonomy in a given stack.

**Example**: Consider the example given in the Overview section for this. Let's fetch **superhero** taxonomy.

Below is the curl command to fetch **superhero** taxonomy

curl --location 'https://api.contentstack.io/v3/taxonomies/superhero' \\  
  
\--header 'api\_key: \*\*\*\*\*\*\*\*\*\*\*\*\*\*' \\  
  
\--header 'authorization: \*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*' \\  
  
\--header 'Content-Type: application/json' \\  
  
\--data ''

View the screenshot below to see the outcome of the postman call.

![cm3.png](https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt7a5e0ccf8f22c799/66491af40bbc62953a7fabeb/cm3.png)

## **Get a single term**

The "Get a single term" request provides detailed information about a single term in a given taxonomy.

Example: Consider the following example, which is provided in the Overview section. Obtain a single term from the superhero taxonomy that refers to powers and abilities.

curl --location 'https://api.contentstack.io/v3/taxonomies/superhero/terms/powers\_and\_abilities' \\  
  
\--header 'api\_key: \*\*\*\*\*\*\*\*\*\*\*\*\*\*\*' \\  
  
\--header 'authorization: \*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*' \\  
  
\--header 'Content-Type: application/json' \\  
  
\--data ''

View the screenshot below to see the outcome of the postman call.

![cm4.png](https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt76708a5e5731c2a7/66491b500a0de6460e314d1e/cm4.png)

## **Create a term**

Within your stack, a term in a specific taxonomy is created via the Create a Term request.

Since terms are organized hierarchically in a taxonomy, it's important to define the order when creating new terms. For instance, when creating a term at the root level, set the parent\_uid as null and specify the level as 1 or above to position it in the list. To create a child term, provide the parent\_uid of the parent term where you want to add the new child term and indicate the desired position within the order parameter.

## Creating a Term  at the Root level

When creating terms at the parent level, the request body should look like this:

**Example:** We would like to  make a new Term at the root level.  For this, consider the example provided in the previous modules. And add the term "Films" to the "Superhero" taxonomy.  Notice that the parent UID is **null**.

Below is the curl command to create a term. 

curl --location 'https://api.contentstack.io/v3/taxonomies/superhero/terms' \\  
  
\--header 'api\_key:\*\*\*\*\*\*\*\*\*\*\*\*\*\*' \\  
  
\--header 'authorization: \*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*' \\  
  
\--header 'Content-Type: application/json' \\  
  
\--data '{  
  
  "term": {  
  
    "uid": "films",  
  
    "name": "Films",  
  
    "parent\_uid": null  
  
  }  
  
}'

View the screenshot below to see the outcome of the postman call.

![cm5.png](https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blte499ee888d5dbecf/66491b9b342fb5f06e62cc64/cm5.png)The result should be a new Term 'Films' located in the Superhero Taxonomy at the root level.  
![cm6.png](https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/bltad086fe9c6e5a3d6/66491bc34ac76eba9f40f88c/cm6.png)

## Creating a Term under a parent Term

When creating terms at the child level, the request body should look like this:

curl --location 'https://api.contentstack.io/v3/taxonomies/superhero/terms' \\  
  
\--header 'api\_key:\*\*\*\*\*\*\*\*\*\*\*\*\*\*' \\  
  
\--header 'authorization: \*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*' \\  
  
\--header 'Content-Type: application/json' \\  
  
\--data '{  
  
  "term": {  
  
    "uid": "scientific\_experimentation",  
  
    "name": "Scientific Experimentation",  
  
    "parent\_uid": "origin"  
  
  }  
  
}'

![cm7.png](https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/bltb7de7c5f1d2ec22f/66491cd2a3f9dfedffc10bc2/cm7.png)  
  
**The result should be a new Term located under the Origin parent term:**

![cm8.png](https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt160628212409b4a6/66491d1cf445aa8b7254c5c4/cm8.png)

#### Key takeaways

- Connect **Content Management APIs for Taxonomy** back to your stack configuration before moving to the next module.
- Capture one concrete artifact (screenshot, Postman call, or code snippet) that proves the step works in your environment.
- Re-read the delivery versus management boundary for anything you changed in the entry model.

## Supplement for indexing

### Content summary

Content Management APIs for Taxonomy. Let's consider an example. Our stack has the following taxonomy created. We have terms inside Superhero , as seen in the image below. ! cm1.png (https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blta2c07a004b22deaf/66491a5c52619de069a90a7a/cm1.png) Get all taxonomies The Get All Taxonomies request provides detailed information about every taxonomy available within your company's specific stack. Example : Let's retrieve every taxonomy found within our stack. Take into consideration the example given in the Overview section. Below is the curl command for the same. curl --location 'https://api.contentstack.io/v3/taxonomies' \\ \--header 'api\ key: \ \ \ \ \ \ \ \ \ \ \ \ \ \ ' \\ \--

### Retrieval tags

- Content
- Management
- APIs
- for
- Taxonomy
- taxonomy-foundations
- lesson 18
- Content Management APIs for Taxonomy
- taxonomy-foundations lesson

### Indexing notes

Index this lesson as a primary chunk tagged with lesson_id "18" and topics: [Content, Management, APIs, for, Taxonomy].
Parent course slug: taxonomy-foundations. Use asset_references URLs as thumbnail hints in search results when present.
Never surface LMS quiz content or assessment answers from this file.

### Asset references

| Label | URL |
| --- | --- |
| cm1.png | `https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blta2c07a004b22deaf/66491a5c52619de069a90a7a/cm1.png` |
| cm2.png | `https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blte56d3a57b7d08f32/66491abb5c2483ea33bc3490/cm2.png` |
| cm3.png | `https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt7a5e0ccf8f22c799/66491af40bbc62953a7fabeb/cm3.png` |
| cm4.png | `https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt76708a5e5731c2a7/66491b500a0de6460e314d1e/cm4.png` |
| cm5.png | `https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blte499ee888d5dbecf/66491b9b342fb5f06e62cc64/cm5.png` |
| cm6.png | `https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/bltad086fe9c6e5a3d6/66491bc34ac76eba9f40f88c/cm6.png` |
| cm7.png | `https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/bltb7de7c5f1d2ec22f/66491cd2a3f9dfedffc10bc2/cm7.png` |
| cm8.png | `https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt160628212409b4a6/66491d1cf445aa8b7254c5c4/cm8.png` |

### External links

| Label | URL |
| --- | --- |
| Contentstack Academy home | `https://www.contentstack.com/academy/` |
| Training instance setup | `https://www.contentstack.com/academy/training-instance` |
| Academy playground (GitHub) | `https://github.com/contentstack/contentstack-academy-playground` |
| Contentstack documentation | `https://www.contentstack.com/docs/` |
| cm1.png | `https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blta2c07a004b22deaf/66491a5c52619de069a90a7a/cm1.png` |
| cm2.png | `https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blte56d3a57b7d08f32/66491abb5c2483ea33bc3490/cm2.png` |
| cm3.png | `https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt7a5e0ccf8f22c799/66491af40bbc62953a7fabeb/cm3.png` |
| cm4.png | `https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt76708a5e5731c2a7/66491b500a0de6460e314d1e/cm4.png` |
| cm5.png | `https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blte499ee888d5dbecf/66491b9b342fb5f06e62cc64/cm5.png` |
| cm6.png | `https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/bltad086fe9c6e5a3d6/66491bc34ac76eba9f40f88c/cm6.png` |
| cm7.png | `https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/bltb7de7c5f1d2ec22f/66491cd2a3f9dfedffc10bc2/cm7.png` |
| cm8.png | `https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt160628212409b4a6/66491d1cf445aa8b7254c5c4/cm8.png` |