PUT /asset/v1/content/categories/{categoryId}
Updates a category in Content Builder.
Name | Type | Description |
---|---|---|
id | Number | Required. The ID of the category. |
Name | Type | Description |
---|---|---|
Id | number | Required. The unique ID of the category, |
Name | string | Required. The name of the category. |
ParentId | number | Required. The ID of the parent category. |
EnterpriseId | number | The enterprise ID (EID) associated with the category. |
CategoryType | string | The type of category. Possible values are asset and asset-shared . |
MemberId | number | The member ID (MID) of the account associated with the category. |
SharingProperties | object | An object that contains the business units that the category is shared with, with and the sharing type for each business unit. This object is included in the response only if the value of CategoryType is asset-shared . |
SharingProperties.SharedWith | object | A list of member IDs (MIDs) that the category is shared with. |
SharingProperties.SharingType | string | Indicates the permission that you’re granting to the list of MIDs that the category is shared with. The only possible value is edit . |
Description | string | A description of the category. |
Status | Name | Type | Description |
---|---|---|---|
200 | A single updated category | ||
Id | string | The unique ID for the category. | |
Name | string | The name of the category. | |
ParentId | number | The ID of the parent category. | |
CategoryType | string | The type of category. Possible values are asset and asset-shared . | |
MemberId | number | The member ID (MID) of the account associated with the category. | |
EnterpriseId | number | The enterprise ID (EID) associated with the category. | |
SharingProperties | object | An object that contains the business units that the category is shared with, with and the sharing type for each business unit. This object is included in the response only if the value of CategoryType is asset-shared . | |
403 | Unauthorized | ||
Message | string | Insufficient privileges | |
ErrorCode | number | 20002 | |
404 | Not found | ||
Message | string | Object not found | |
ErrorCode | number | 30003 | |
500 | Internal server error | ||
Message | string | No message | |
ErrorCode | number | 10000 |
To update a category, issue a PUT request to the /asset/v1/content/categories/{categoryId}
endpoint, replacing {categoryId}
with the unique ID of the category that you want to update.
The response contains information about the updated category.