PATCH /hub/v1/nestedtags/{tagId}
Updates an existing tag. Provide only the tag fields to be changed.
Name | Type | Description | |
---|---|---|---|
tagId | number | Required | ID of the tag to patch. |
Name | Type | Description | |
---|---|---|---|
id | number | Required | TagId of the tag to update. |
name | string | Name of the tag, up to 120 characters. The only special characters allowed are period (.) and apostrophe ('). | |
description | string | Description 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, the existing description is not changed. | |
parentId | number | TagId that you want to be the parent of this tag. If you don’t provide a parentId, the parentId is not changed. | |
tags | object | A list of tags to create as nested tags. If you don’t provide a list of tags, the existing nested tags are not changed. |
Status | Name | Type | Description |
---|---|---|---|
200 | Response includes the updated tag and all of its properties, including nested tags at the level specified by the depth parameter. | ||
id | integer | TagId of the tag. | |
name | string | Name of the tag. | |
description | string | Description of the tag. | |
parentId | string | TagId of the parent tag. This field is null or zero if no parent tag exists. | |
tags | object | A list of the tag’s nested tags. |
This example patches a nested tag to update its description field.
This example changes a nested tag into a root tag with no parent.