PUT /hub/v1/nestedtags/{tagId}

Overview

Updates an existing tag. You must provide the entire tag payload because this request modifies the entire tag. To provide only the fields to modify, use the Patch Nested Tags request instead.

URL Parameters

NameTypeDescription
tagIdnumberRequiredID of the tag to update.

JSON Parameters

NameTypeDescription
idnumberRequiredTagId of the tag to update.
namestringRequiredName of the tag, up to 120 characters. The only special characters allowed are period (.) and apostrophe (').
descriptionstringDescription of the tag, up to 256 characters. The only special characters allowed are period (.), apostrophe ('), comma (,), and forward slash (/). If you don’t provide a description, any existing description is erased.
parentIdnumberTagId that you want to be the parent of this tag. If you don’t provide a parentId, the parentId (if non-zero) is replaced by zero, meaning no parent tag.
tagsobjectA list of tags to create as nested tags. If you don’t provide a list of tags, any existing tags are removed.

Usage

Example Request

This example renames descriptions of all tags nested under a parent tag ID.

Example Response