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 isn’t changed. |
| parentId | number | TagId that you want to be the parent of this tag. If you don’t provide a parentId, the parentId isn’t 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 aren’t 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.
The response includes the updated information for the tag.
This example changes a nested tag into a root tag with no parent.
The response indicates the changed status of the tag.