Content Taxonomy, Term

Get, update, or delete a term within a content taxonomy.

Resource

1/connect/content-taxonomy/taxonomyId/terms/termId

Available version

63.0

HTTP methods

GET, PATCH, DELETE

Response body for GET

Content Taxonomy Term

Request body for PATCH

Root XML tag

<term>

JSON example

1{
2"label" : "Fruit",
3"description" : "The seed-bearing part of a flowering plant.",
4"parentTermId" : ""
5}

Properties

Name	Type	Description	Required or Optional	Available Version
`description`	String	Description of the term.	Required when creating a term Optional when updating a term	63.0
`label`	String	Label of the term.	Required when creating a term Optional when updating a term	63.0
`parentTermId`	String	ID of the parent term. If unspecified when creating a term, creates a root term. If unspecified when updating a term, no changes are made.	Optional	63.0

Response body for PATCH

Content Taxonomy Term

Request parameters for DELETE

Parameter Name	Type	Description	Required or Optional	Available Version
`deleteChildren`	Boolean	Specifies whether to delete the child terms of the term (`true`) or not (`false`).	Required	63.0
`newParentTerm`	String	ID of the term that becomes the parent term if `deleteChildren` is `false`. If unspecified and `deleteChildren` is `false`, the child terms become root terms.	Optional	63.0

Response for DELETE

204: Successful Delete

Connect REST API Developer Guide