Update a category
put
/content/management/api/v1.1/taxonomies/{id}/categories/{categoryId}
with given payload.
Request
Supported Media Types
- application/json
Path Parameters
-
categoryId: string
Unique identifier (id) for a category.
-
id: string
id of the taxonomy.
Query Parameters
-
links(optional): string
This parameter accepts a comma-separated list of link names. By default, this parameter gives all the links applicable. Possible values are: self, canonical, describedby
-
q(optional): string
Query expression.
Header Parameters
-
X-Requested-With: string
A custom header to mitigate CSRF attacks.Allowed Values:
[ "XMLHttpRequest" ]
Updates a category with the given information in the payload. The fields id, children, idPath, namePath and links will be ignored even if given in the payload.
The parentId when provided can be used to move the category and the tree below it to another parent category in the taxonomy. If the parentId is not provided, the category location is not affected.
The position field can be used to specify the order of the category among its siblings. If no position is provided the category will retain its current position.
The apiName field can be used to uniquely identify the category across all taxonomies. This field is case insensitive. It will be automatically prefixed with the unique taxonomy shortName in case the payload does not have it already.
The synonyms field is a comma-separated list of values that will be assigned to the synonyms system managed category property of the taxonomy.
The keywords field is a comma-separated list of values that will be assigned to the keywords system managed category property of the taxonomy.
The relatedCategories field is a list where each element represents a category that will be related to the current category, and these values will be assigned to the relatedCategories system managed category property of the taxonomy.
The customProperties field represents the property values for the user defined category properties. To assign values for a specific custom category property you must provide the apiName of the category property followed by the list of values. If no value is provided for an existing custom category property, server will assign the default values of the category property automatically.
The parentId when provided can be used to move the category and the tree below it to another parent category in the taxonomy. If the parentId is not provided, the category location is not affected.
The position field can be used to specify the order of the category among its siblings. If no position is provided the category will retain its current position.
The apiName field can be used to uniquely identify the category across all taxonomies. This field is case insensitive. It will be automatically prefixed with the unique taxonomy shortName in case the payload does not have it already.
The synonyms field is a comma-separated list of values that will be assigned to the synonyms system managed category property of the taxonomy.
The keywords field is a comma-separated list of values that will be assigned to the keywords system managed category property of the taxonomy.
The relatedCategories field is a list where each element represents a category that will be related to the current category, and these values will be assigned to the relatedCategories system managed category property of the taxonomy.
The customProperties field represents the property values for the user defined category properties. To assign values for a specific custom category property you must provide the apiName of the category property followed by the list of values. If no value is provided for an existing custom category property, server will assign the default values of the category property automatically.
Root Schema : CategoryInformation
Type:
object
Category Information
Show Source
-
ancestors(optional):
array ancestors
The ancestors of the Category. First element represents the root category and the last element represents the immediate parent of the category.
-
apiName(optional):
string
The apiName of the Category. This property uniquely identify a category across taxonomies and it will be automatically generated if not provided on creation or updates. This is an optional property in get and post requests.
-
children(optional):
object CollectionPropertiesCategoryInCollection
CollectionProperties.
-
customProperties(optional):
object customProperties
Additional Properties Allowed: CustomPropertyValuesBeanThe custom properties' values of the Category.
-
description(optional):
string
The description of the Category.
-
id(optional):
string
The id of the Category. This is a required property in the get response and ignored in post/put requests.
-
idPath(optional):
string
Full id path from the root category to this category separated by '/'. This is an optional property in get requests and ignored in post/put requests.
-
isSiteCategory(optional):
boolean
Whether the Category is a site category. (defaults to false)
-
keywords(optional):
array keywords
The keywords of the Category.
-
links(optional):
array links
Links
-
name:
string
The name of the Category. It is a required property in the get response and cannot be empty in post / put requests.
-
namePath(optional):
string
Full name path from the root category to this category separated by '/'. This is an optional property in get requests and ignored in post/put requests.
-
parent(optional):
object CategoryAncestorBean
-
parentId(optional):
string
The parentId of the Category. This is a required property in get and post requests. When it is provided in a put request it can be used to move a category and the tree below it to another parent category in the taxonomy.
-
position(optional):
integer(int32)
Minimum Value:
0
The position of the Category among its siblings. This is a required property in the get response. - relatedCategories(optional): array relatedCategories
-
roleName(optional):
string
name of the role on the resource.
-
status(optional):
string
Allowed Values:
[ "draft", "promoted" ]
The status of the Category. This is a required property in the get response and ignored in post/put requests. -
suggestedItems(optional):
object ItemSubResourceListItem
Item SubResource.
-
synonyms(optional):
array synonyms
The synonyms of the Category.
Nested Schema : ancestors
Type:
array
The ancestors of the Category. First element represents the root category and the last element represents the immediate parent of the category.
Show Source
Nested Schema : CollectionPropertiesCategoryInCollection
Type:
object
CollectionProperties.
Show Source
-
aggregationResults(optional):
array aggregationResults
Aggregation results.
-
count(optional):
integer(int32)
Total number of records in the current response.
-
hasMore(optional):
boolean
Check whether there are more pages to fetch.
-
items(optional):
array items
Singular resources contained in the collection.
-
limit(optional):
integer(int32)
Actual page size used by the server. This might not be the same as what the client requests.
-
links(optional):
array links
Links of the resource.
-
offset(optional):
integer(int32)
The actual index from which the singular resources are returned.
-
pinned(optional):
array pinned
Pinned items. Shows items pinned at the top of search list
-
scrollId(optional):
string
scrollId if the search resolved to a scroll search.
-
totalResults(optional):
integer(int32)
Total number of rows that satisfy the client request (excluding the paging parameters.)
Nested Schema : customProperties
Type:
object
Additional Properties Allowed
Show Source
The custom properties' values of the Category.
Nested Schema : CategoryAncestorBean
Type:
Show Source
object
-
apiName(optional):
string
The apiName of the Category ancestor
-
id(optional):
string
The id of the Category ancestor.
-
name(optional):
string
The name of the Category ancestor.
Nested Schema : items
Type:
array
Singular resources contained in the collection.
Show Source
-
Array of:
object CategoryInCollection
Category in Collection Response
Nested Schema : links
Type:
array
Links of the resource.
Show Source
-
Array of:
object Link
Link of the resource.
Nested Schema : pinned
Type:
array
Pinned items. Shows items pinned at the top of search list
Show Source
Nested Schema : CategoryInCollection
Type:
object
Category in Collection Response
Show Source
-
apiName(optional):
string
The apiName of the Category. This property uniquely identify a category across taxonomies and it will be automatically generated if not provided on creation or updates. This is an optional property in get and post requests.
-
customProperties(optional):
object customProperties
Additional Properties Allowed: CustomPropertyValuesBeanThe custom properties' values of the Category.
-
description(optional):
string
The description of the Category.
-
id(optional):
string
The id of the Category. This is a required property in the get response and ignored in post/put requests.
-
isSiteCategory(optional):
boolean
Whether the Category is a site category. (defaults to false)
-
keywords(optional):
array keywords
The keywords of the Category.
-
links(optional):
array links
Links
-
name:
string
The name of the Category. It is a required property in the get response and cannot be empty in post / put requests.
-
parentId(optional):
string
The parentId of the Category. This is a required property in get and post requests. When it is provided in a put request it can be used to move a category and the tree below it to another parent category in the taxonomy.
-
position(optional):
integer(int32)
Minimum Value:
0
The position of the Category among its siblings. This is a required property in the get response. - relatedCategories(optional): array relatedCategories
-
roleName(optional):
string
name of the role on the resource.
-
status(optional):
string
Allowed Values:
[ "draft", "promoted" ]
The status of the Category. This is a required property in the get response and ignored in post/put requests. -
suggestedItems(optional):
object ItemSubResourceListItem
Item SubResource.
-
synonyms(optional):
array synonyms
The synonyms of the Category.
Nested Schema : customProperties
Type:
object
Additional Properties Allowed
Show Source
The custom properties' values of the Category.
Nested Schema : CustomPropertyValuesBean
Type:
Show Source
object
-
values(optional):
array values
The list of values of the custom property.
Nested Schema : CustomPropertyValue
Type:
Show Source
object
-
id(optional):
string
Read Only:
true
The id of the custom property value. -
value(optional):
string
The value of the custom property.
Nested Schema : Link
Type:
object
Link of the resource.
Show Source
-
href(optional):
string
The target resource's URI. It could be template URI. It is a required property in the get response.
-
mediaType(optional):
string
Media type.
-
method(optional):
string
What HTTP method can be used to access the target resource.
-
profile(optional):
string
Link to the metadata that describes the target resource.
-
rel(optional):
string
Relation type. It is a required property in the get response.
-
templated(optional):
boolean
Whether the URI is a template.
Nested Schema : RelatedCategory
Type:
object
Related Category
Show Source
-
apiName(optional):
string
The apiName of the category.
-
id(optional):
string
The id of the category.
-
name(optional):
string
The name of the category.
-
nodes(optional):
array nodes
The path of the category.
-
taxonomy(optional):
object RelatedTaxonomyBean
Nested Schema : RelatedTaxonomyBean
Type:
Show Source
object
-
id(optional):
string
The id of the taxonomy.
-
name(optional):
string
The name of the taxonomy.
-
shortName(optional):
string
The short name of the taxonomy.
Nested Schema : CategoryNodeBean
Type:
Show Source
object
-
apiName(optional):
string
The apiName of the Category node.
-
id(optional):
string
The id of the Category node.
-
name(optional):
string
The name of the Category node.
Nested Schema : Item
Type:
object
Discriminator:
typeCategory
Item
Show Source
-
changes(optional):
object ItemSubResourceListChangesInfo
Item SubResource.
-
channels(optional):
object ItemSubResourceListChannelId
Item SubResource.
-
collections(optional):
object ItemSubResourceListCollectionId
Item SubResource.
-
connectorFileInfo(optional):
object ItemSubResourceConnectorFileInfo
Item SubResource.
-
connectorId(optional):
string
Connector Id of the item.
-
connectorSyncEnabled(optional):
boolean
Connector Sync Enabled flag of the item.
-
createdBy(optional):
string
Created by.
-
createdByUser(optional):
object User
User object
-
createdDate(optional):
object date
date
-
description(optional):
string
description of the item
-
fields(optional):
object fields
Read Only:
true
Additional Properties Allowed: additionalPropertiesUser-defined fields data. Map. All the user-defined fields required in the type definition must be provided under this property in PUT and POST request. -
fileExtension(optional):
string
Extension of the file.
-
id(optional):
string
id of the item. It is a required property in the get response and put request whereas it is not required in the post request.
-
isPublished(optional):
boolean
Whether the item is ever published.
-
language(optional):
string
Language of the item.
-
languageIsMaster(optional):
boolean
Whether the item is master.
-
links(optional):
array links
Links
-
lockInfo(optional):
object ItemSubResourceLockInfo
Item SubResource.
-
metadata(optional):
object ItemMetadataInfo
ItemMetadataInfo
-
name(optional):
string
Name of the item. It is a required property in the get response and post/put request.
-
permissions(optional):
object ItemSubResourceListAction
Item SubResource.
-
publishedChannels(optional):
object ItemSubResourceListChannelId
Item SubResource.
-
publishInfo(optional):
object ItemSubResourceListPublishInfo
Item SubResource.
-
reference(optional):
object ItemReferenceInfo
ItemReferenceInfo
-
relationships(optional):
object ItemSubResourceRelationships
Item SubResource.
-
repositoryId(optional):
string
Repository of the item. It is a required property in the get response and post/put request.
-
scheduled(optional):
boolean
-
slug(optional):
string
URL slug of the item.
-
sourceId(optional):
string
Source Id.
-
status(optional):
string
Current status of the item.
-
suggestedTaxonomies(optional):
object ItemSubResourceListSuggestedTaxonomyInfo
Item SubResource.
-
tags(optional):
object ItemSubResourceListTag
Item SubResource.
-
taxonomies(optional):
object ItemSubResourceListTaxonomyInfo
Item SubResource.
-
translatable(optional):
boolean
Whether the item is translatable.
-
type(optional):
string
Name of the type. It is a required property in the get response and post/put request.
-
typeCategory(optional):
string
Read Only:
true
-
updatedBy(optional):
string
Updated by.
-
updatedByUser(optional):
object User
User object
-
updatedDate(optional):
object date
date
-
variations(optional):
object ItemSubResourceListVariationsInfo
Item SubResource.
-
version(optional):
string
The current revision version of this item.
-
versionInfo(optional):
object ItemSubResourceListVersionInfo
Item SubResource.
-
video(optional):
object VideoBean
VideoBean
-
workflowInstances(optional):
object WorkflowField
All mapped workflow fields
-
workflows(optional):
object ItemSubResourceListWorkflowInfo
Item SubResource.
Nested Schema : User
Type:
object
User object
Show Source
-
displayName(optional):
string
Read Only:
true
display name of the user. -
email(optional):
string
Read Only:
true
email of the user. -
userID(optional):
integer(int64)
Read Only:
true
id of the user. -
userName(optional):
string
Read Only:
true
name of the user.
Nested Schema : fields
Type:
object
Read Only:
true
Additional Properties Allowed
Show Source
User-defined fields data. Map. All the user-defined fields required in the type definition must be provided under this property in PUT and POST request.
Nested Schema : ItemMetadataInfo
Type:
object
ItemMetadataInfo
Show Source
-
exif(optional):
object EXIFMetadata
EXIF Metadata
-
links(optional):
array links
Links
-
transcripts(optional):
object VideoTranscriptMetadata
Video Transcription Metadata
Nested Schema : ItemReferenceInfo
Type:
object
ItemReferenceInfo
Show Source
-
isAccessible(optional):
boolean
Whether the item is accessible.
Nested Schema : VideoBean
Type:
object
VideoBean
Show Source
-
duration(optional):
string
Read Only:
true
The duration of the video in ISO 8601 format. -
isFormatSupported(optional):
boolean
Read Only:
true
A boolean expressing if the video file format is supported. -
playback(optional):
object PlaybackBean
PlaybackBean
-
processing(optional):
object ProcessingBean
ProcessingBean
-
strip(optional):
object StripBean
StripBean
Nested Schema : WorkflowField
Type:
object
All mapped workflow fields
Show Source
-
aggregationResults(optional):
array aggregationResults
Aggregation results.
-
count(optional):
integer(int32)
Total number of records in the current response.
-
hasMore(optional):
boolean
Check whether there are more pages to fetch.
-
items(optional):
array items
Singular resources contained in the collection.
-
limit(optional):
integer(int32)
Actual page size used by the server. This might not be the same as what the client requests.
-
links(optional):
array links
Links of the resource.
-
offset(optional):
integer(int32)
The actual index from which the singular resources are returned.
-
pinned(optional):
array pinned
Pinned items. Shows items pinned at the top of search list
-
scrollId(optional):
string
scrollId if the search resolved to a scroll search.
-
totalResults(optional):
integer(int32)
Total number of rows that satisfy the client request (excluding the paging parameters.)
Nested Schema : ChangesInfo
Type:
object
ChangesInfo
Show Source
-
links(optional):
array links
-
source(optional):
string
Sub-resource associated to this item which is source of this change.
-
type(optional):
string
Type of change tracked for the given source.
-
value(optional):
boolean
True indicates a change. False indicates no current changes for this source/type.
Nested Schema : ChannelId
Type:
object
ChannelId
Show Source
-
id(optional):
string
-
isPrimaryChannel(optional):
boolean
Indicates if channel is primary for an asset.
-
links(optional):
array links
Links
-
name(optional):
string
Nested Schema : ConnectorFileInfo
Type:
object
ConnectorFileInfo
Show Source
-
connectorId(optional):
string
Connector id.
-
id(optional):
string
File id.
-
inUse(optional):
boolean
Represents whether the latest version of asset is using the file content.
-
version(optional):
integer(int32)
File version
Nested Schema : additionalProperties
Type:
object
Nested Schema : LockInfo
Type:
object
LockInfo
Show Source
-
isLocked(optional):
boolean
Represents whether the item is locked or not.
-
lockedBy(optional):
string
Locked by user
-
lockedDate(optional):
object date
date
Nested Schema : EXIFMetadata
Type:
object
EXIF Metadata
Show Source
-
aggregationResults(optional):
array aggregationResults
Aggregation results.
-
count(optional):
integer(int32)
Total number of records in the current response.
-
hasMore(optional):
boolean
Check whether there are more pages to fetch.
-
items(optional):
array items
Singular resources contained in the collection.
-
limit(optional):
integer(int32)
Actual page size used by the server. This might not be the same as what the client requests.
-
links(optional):
array links
Links of the resource.
-
offset(optional):
integer(int32)
The actual index from which the singular resources are returned.
-
pinned(optional):
array pinned
Pinned items. Shows items pinned at the top of search list
-
scrollId(optional):
string
scrollId if the search resolved to a scroll search.
-
totalResults(optional):
integer(int32)
Total number of rows that satisfy the client request (excluding the paging parameters.)
Nested Schema : VideoTranscriptMetadata
Type:
object
Video Transcription Metadata
Show Source
-
aggregationResults(optional):
array aggregationResults
Aggregation results.
-
count(optional):
integer(int32)
Total number of records in the current response.
-
hasMore(optional):
boolean
Check whether there are more pages to fetch.
-
items(optional):
array items
Singular resources contained in the collection.
-
limit(optional):
integer(int32)
Actual page size used by the server. This might not be the same as what the client requests.
-
links(optional):
array links
Links of the resource.
-
offset(optional):
integer(int32)
The actual index from which the singular resources are returned.
-
pinned(optional):
array pinned
Pinned items. Shows items pinned at the top of search list
-
scrollId(optional):
string
scrollId if the search resolved to a scroll search.
-
totalResults(optional):
integer(int32)
Total number of rows that satisfy the client request (excluding the paging parameters.)
Nested Schema : items
Type:
array
Singular resources contained in the collection.
Show Source
-
Array of:
object ItemExtractedExifBean
ItemExtractedExifBean
Nested Schema : links
Type:
array
Links of the resource.
Show Source
-
Array of:
object Link
Link of the resource.
Nested Schema : pinned
Type:
array
Pinned items. Shows items pinned at the top of search list
Show Source
Nested Schema : ItemExtractedExifBean
Type:
object
ItemExtractedExifBean
Show Source
-
floatValue(optional):
number(float)
The float value of the EXIF field. This value will be a numeric representation of the EXIF field value with decimal precision.
-
handle(optional):
string
The handle or EXIF field name. This value is not translatable.
-
integerValue(optional):
integer(int32)
The integer value of the EXIF field. This value will be a numeric representation of the EXIF field value without a decimal point.
-
links(optional):
array links
Links
-
rawId(optional):
string
The ID of the EXIF field. Uniquely identifies one EXIF field.
-
rawValue(optional):
string
The raw EXIF field value. This value can be a numeric value out of a predefined value list or a text value.
-
stringValue(optional):
string
The text value of the EXIF field. This value will be a text representation of the EXIF field value.
-
type(optional):
string
The data type of the EXIF field. (date, integer, float, string).
-
value(optional):
string
The display value of the EXIF field. This value will be a text representation of the actual type value of the EXIF field (date, int, float, string).
Nested Schema : items
Type:
array
Singular resources contained in the collection.
Show Source
-
Array of:
object Videotranscript
Video transcript
Nested Schema : links
Type:
array
Links of the resource.
Show Source
-
Array of:
object Link
Link of the resource.
Nested Schema : pinned
Type:
array
Pinned items. Shows items pinned at the top of search list
Show Source
Nested Schema : Videotranscript
Type:
object
Video transcript
Show Source
-
end(optional):
string
End of each transcript node.
-
id(optional):
string
Id of each transcript node.
-
links(optional):
array links
Links
-
start(optional):
string
Start of each transcript node.
-
text(optional):
string
Text of each transcript node.
Nested Schema : Action
Type:
object
Action
Show Source
-
action(optional):
string
Allowed Values:
[ "view", "update", "create", "delete" ]
action is allowed on the resource
Nested Schema : PublishInfo
Type:
object
PublishInfo
Show Source
-
channel(optional):
string
Target name
-
links(optional):
array links
Links
-
publishedBy(optional):
string
Published by
-
publishedDate(optional):
object date
date
-
slug(optional):
string
Published slug
-
version(optional):
string
Published version
Nested Schema : Relationships
Type:
object
Relationships
Show Source
-
referencedBy(optional):
array referencedBy
Referenced by ids
-
referencedBySitePlan(optional):
object Siteplanreference
Site plan reference
-
referencedBySites(optional):
array referencedBySites
Referenced by sites
-
references(optional):
array references
Reference ids
Nested Schema : referencedBy
Type:
array
Referenced by ids
Show Source
-
Array of:
object References
References
Nested Schema : Siteplanreference
Type:
object
Site plan reference
Show Source
-
id(optional):
string
id of the site plan.
-
links(optional):
array links
Nested Schema : referencedBySites
Type:
array
Referenced by sites
Show Source
-
Array of:
object ReferencedBySites
ReferencedBySites
Nested Schema : references
Type:
array
Reference ids
Show Source
-
Array of:
object References
References
Nested Schema : References
Type:
object
References
Show Source
-
id(optional):
string
id of the item.
-
links(optional):
array links
-
reference(optional):
object ItemReferenceInfo
ItemReferenceInfo
Nested Schema : ReferencedBySites
Type:
object
ReferencedBySites
Show Source
-
component(optional):
string
Component of the item
-
pageId(optional):
string
Page the item added to
-
site(optional):
string
Site the item added to
Nested Schema : data
Type:
Show Source
array
-
Array of:
object SuggestedTaxonomyInfo
SuggestedTaxonomyInfo
Nested Schema : SuggestedTaxonomyInfo
Type:
object
SuggestedTaxonomyInfo
Show Source
-
categories(optional):
array categories
Categories in the Suggested Taxonomy the item belongs to.
-
id(optional):
string
-
links(optional):
array links
-
name(optional):
string
-
shortName(optional):
string
Nested Schema : categories
Type:
array
Categories in the Suggested Taxonomy the item belongs to.
Show Source
Nested Schema : ItemSuggestedCategoryInfo
Type:
Show Source
object
-
apiName(optional):
string
The apiName of the category assigned to the item.
-
id(optional):
string
-
isRejected(optional):
boolean
Status of the Suggested Category for the Item.
-
links(optional):
array links
-
name(optional):
string
-
nodes(optional):
array nodes
Nodes in the category assigned to the item.
-
order(optional):
integer(int32)
Probability order of the Suggested Category across all the Taxonomies assigned to the repository.
Nested Schema : Tag
Type:
object
Tag.
Show Source
-
language:
string
language of the tag.
-
links(optional):
array links
Links
-
name:
string
Name of the tag.
Nested Schema : TaxonomyInfo
Type:
object
TaxonomyInfo
Show Source
-
categories(optional):
array categories
Categories in the Taxonomy the item belongs to.
-
id(optional):
string
-
links(optional):
array links
-
name(optional):
string
-
shortName(optional):
string
Nested Schema : ItemCategoryInfo
Type:
Show Source
object
-
apiName(optional):
string
The apiName of the category assigned to the item.
-
id(optional):
string
-
links(optional):
array links
-
name(optional):
string
-
nodes(optional):
array nodes
Nodes in the category assigned to the item.
Nested Schema : VariationsInfo
Type:
object
Variations Info.
Show Source
-
items(optional):
array items
Content item variations.
-
links(optional):
array links
-
masterItem(optional):
string
Master item.
-
setId(optional):
string
Variation set id.
-
varType(optional):
string
Variation type name.
Nested Schema : items
Type:
array
Content item variations.
Show Source
-
Array of:
object Language
LanguageItem
Nested Schema : Language
Type:
object
LanguageItem
Show Source
-
id(optional):
string
id of the item.
-
isPublished(optional):
boolean
Whether the item is ever published.
-
links(optional):
array links
-
name(optional):
string
name of the item.
-
status(optional):
string
status of item
-
value(optional):
string
Language value
Nested Schema : VersionInfo
Type:
object
VersionInfo
Show Source
-
latestVersion(optional):
string
Latest version
-
publishedVersion(optional):
string
Published version
Nested Schema : PlaybackBean
Type:
object
PlaybackBean
Show Source
-
adaptiveStreams(optional):
object AdaptiveStreamsBean
AdaptiveStreamsBean
Nested Schema : ProcessingBean
Type:
object
ProcessingBean
Show Source
-
progress(optional):
string
Read Only:
true
The progress of the background process. The value of this field will be one of PENDING, SUCCEEDED or FAILED.
Nested Schema : StripBean
Type:
object
StripBean
Show Source
-
frame(optional):
object StripFrameBean
StripFrameBean
Nested Schema : AdaptiveStreamsBean
Type:
object
AdaptiveStreamsBean
Show Source
-
dash(optional):
object PlaybackBean
PlaybackBean
-
hls(optional):
object PlaybackBean
PlaybackBean
Nested Schema : StripFrameBean
Type:
object
StripFrameBean
Show Source
-
count(optional):
integer(int32)
Read Only:
true
The number of frames in the strip image. -
height(optional):
integer(int32)
Read Only:
true
The height of the strip image. -
width(optional):
integer(int32)
Read Only:
true
The width of the strip image.
Nested Schema : items
Type:
array
Singular resources contained in the collection.
Show Source
-
Array of:
object WorkflowInfo
WorkflowInfo.
Nested Schema : links
Type:
array
Links of the resource.
Show Source
-
Array of:
object Link
Link of the resource.
Nested Schema : pinned
Type:
array
Pinned items. Shows items pinned at the top of search list
Show Source
Nested Schema : WorkflowInfo
Type:
object
WorkflowInfo.
Show Source
-
id(optional):
string
Workflow id.
-
instanceId:
string
Workflow instance id.
-
isCompleted(optional):
boolean
If workflow instance is completed or not in OIC.
-
links(optional):
array links
Links
-
name(optional):
string
Workflow name.
-
status(optional):
string
Workflow status.
-
submittedBy(optional):
string
Submitted by user
-
submittedDate(optional):
object date
date
Response
Supported Media Types
- application/json
200 Response
OK.
Root Schema : CategoryInformation
Type:
object
Category Information
Show Source
-
ancestors(optional):
array ancestors
The ancestors of the Category. First element represents the root category and the last element represents the immediate parent of the category.
-
apiName(optional):
string
The apiName of the Category. This property uniquely identify a category across taxonomies and it will be automatically generated if not provided on creation or updates. This is an optional property in get and post requests.
-
children(optional):
object CollectionPropertiesCategoryInCollection
CollectionProperties.
-
customProperties(optional):
object customProperties
Additional Properties Allowed: CustomPropertyValuesBeanThe custom properties' values of the Category.
-
description(optional):
string
The description of the Category.
-
id(optional):
string
The id of the Category. This is a required property in the get response and ignored in post/put requests.
-
idPath(optional):
string
Full id path from the root category to this category separated by '/'. This is an optional property in get requests and ignored in post/put requests.
-
isSiteCategory(optional):
boolean
Whether the Category is a site category. (defaults to false)
-
keywords(optional):
array keywords
The keywords of the Category.
-
links(optional):
array links
Links
-
name:
string
The name of the Category. It is a required property in the get response and cannot be empty in post / put requests.
-
namePath(optional):
string
Full name path from the root category to this category separated by '/'. This is an optional property in get requests and ignored in post/put requests.
-
parent(optional):
object CategoryAncestorBean
-
parentId(optional):
string
The parentId of the Category. This is a required property in get and post requests. When it is provided in a put request it can be used to move a category and the tree below it to another parent category in the taxonomy.
-
position(optional):
integer(int32)
Minimum Value:
0
The position of the Category among its siblings. This is a required property in the get response. - relatedCategories(optional): array relatedCategories
-
roleName(optional):
string
name of the role on the resource.
-
status(optional):
string
Allowed Values:
[ "draft", "promoted" ]
The status of the Category. This is a required property in the get response and ignored in post/put requests. -
suggestedItems(optional):
object ItemSubResourceListItem
Item SubResource.
-
synonyms(optional):
array synonyms
The synonyms of the Category.
Nested Schema : ancestors
Type:
array
The ancestors of the Category. First element represents the root category and the last element represents the immediate parent of the category.
Show Source
Nested Schema : CollectionPropertiesCategoryInCollection
Type:
object
CollectionProperties.
Show Source
-
aggregationResults(optional):
array aggregationResults
Aggregation results.
-
count(optional):
integer(int32)
Total number of records in the current response.
-
hasMore(optional):
boolean
Check whether there are more pages to fetch.
-
items(optional):
array items
Singular resources contained in the collection.
-
limit(optional):
integer(int32)
Actual page size used by the server. This might not be the same as what the client requests.
-
links(optional):
array links
Links of the resource.
-
offset(optional):
integer(int32)
The actual index from which the singular resources are returned.
-
pinned(optional):
array pinned
Pinned items. Shows items pinned at the top of search list
-
scrollId(optional):
string
scrollId if the search resolved to a scroll search.
-
totalResults(optional):
integer(int32)
Total number of rows that satisfy the client request (excluding the paging parameters.)
Nested Schema : customProperties
Type:
object
Additional Properties Allowed
Show Source
The custom properties' values of the Category.
Nested Schema : CategoryAncestorBean
Type:
Show Source
object
-
apiName(optional):
string
The apiName of the Category ancestor
-
id(optional):
string
The id of the Category ancestor.
-
name(optional):
string
The name of the Category ancestor.
Nested Schema : items
Type:
array
Singular resources contained in the collection.
Show Source
-
Array of:
object CategoryInCollection
Category in Collection Response
Nested Schema : links
Type:
array
Links of the resource.
Show Source
-
Array of:
object Link
Link of the resource.
Nested Schema : pinned
Type:
array
Pinned items. Shows items pinned at the top of search list
Show Source
Nested Schema : CategoryInCollection
Type:
object
Category in Collection Response
Show Source
-
apiName(optional):
string
The apiName of the Category. This property uniquely identify a category across taxonomies and it will be automatically generated if not provided on creation or updates. This is an optional property in get and post requests.
-
customProperties(optional):
object customProperties
Additional Properties Allowed: CustomPropertyValuesBeanThe custom properties' values of the Category.
-
description(optional):
string
The description of the Category.
-
id(optional):
string
The id of the Category. This is a required property in the get response and ignored in post/put requests.
-
isSiteCategory(optional):
boolean
Whether the Category is a site category. (defaults to false)
-
keywords(optional):
array keywords
The keywords of the Category.
-
links(optional):
array links
Links
-
name:
string
The name of the Category. It is a required property in the get response and cannot be empty in post / put requests.
-
parentId(optional):
string
The parentId of the Category. This is a required property in get and post requests. When it is provided in a put request it can be used to move a category and the tree below it to another parent category in the taxonomy.
-
position(optional):
integer(int32)
Minimum Value:
0
The position of the Category among its siblings. This is a required property in the get response. - relatedCategories(optional): array relatedCategories
-
roleName(optional):
string
name of the role on the resource.
-
status(optional):
string
Allowed Values:
[ "draft", "promoted" ]
The status of the Category. This is a required property in the get response and ignored in post/put requests. -
suggestedItems(optional):
object ItemSubResourceListItem
Item SubResource.
-
synonyms(optional):
array synonyms
The synonyms of the Category.
Nested Schema : customProperties
Type:
object
Additional Properties Allowed
Show Source
The custom properties' values of the Category.
Nested Schema : CustomPropertyValuesBean
Type:
Show Source
object
-
values(optional):
array values
The list of values of the custom property.
Nested Schema : CustomPropertyValue
Type:
Show Source
object
-
id(optional):
string
Read Only:
true
The id of the custom property value. -
value(optional):
string
The value of the custom property.
Nested Schema : Link
Type:
object
Link of the resource.
Show Source
-
href(optional):
string
The target resource's URI. It could be template URI. It is a required property in the get response.
-
mediaType(optional):
string
Media type.
-
method(optional):
string
What HTTP method can be used to access the target resource.
-
profile(optional):
string
Link to the metadata that describes the target resource.
-
rel(optional):
string
Relation type. It is a required property in the get response.
-
templated(optional):
boolean
Whether the URI is a template.
Nested Schema : RelatedCategory
Type:
object
Related Category
Show Source
-
apiName(optional):
string
The apiName of the category.
-
id(optional):
string
The id of the category.
-
name(optional):
string
The name of the category.
-
nodes(optional):
array nodes
The path of the category.
-
taxonomy(optional):
object RelatedTaxonomyBean
Nested Schema : RelatedTaxonomyBean
Type:
Show Source
object
-
id(optional):
string
The id of the taxonomy.
-
name(optional):
string
The name of the taxonomy.
-
shortName(optional):
string
The short name of the taxonomy.
Nested Schema : CategoryNodeBean
Type:
Show Source
object
-
apiName(optional):
string
The apiName of the Category node.
-
id(optional):
string
The id of the Category node.
-
name(optional):
string
The name of the Category node.
Nested Schema : Item
Type:
object
Discriminator:
typeCategory
Item
Show Source
-
changes(optional):
object ItemSubResourceListChangesInfo
Item SubResource.
-
channels(optional):
object ItemSubResourceListChannelId
Item SubResource.
-
collections(optional):
object ItemSubResourceListCollectionId
Item SubResource.
-
connectorFileInfo(optional):
object ItemSubResourceConnectorFileInfo
Item SubResource.
-
connectorId(optional):
string
Connector Id of the item.
-
connectorSyncEnabled(optional):
boolean
Connector Sync Enabled flag of the item.
-
createdBy(optional):
string
Created by.
-
createdByUser(optional):
object User
User object
-
createdDate(optional):
object date
date
-
description(optional):
string
description of the item
-
fields(optional):
object fields
Read Only:
true
Additional Properties Allowed: additionalPropertiesUser-defined fields data. Map. All the user-defined fields required in the type definition must be provided under this property in PUT and POST request. -
fileExtension(optional):
string
Extension of the file.
-
id(optional):
string
id of the item. It is a required property in the get response and put request whereas it is not required in the post request.
-
isPublished(optional):
boolean
Whether the item is ever published.
-
language(optional):
string
Language of the item.
-
languageIsMaster(optional):
boolean
Whether the item is master.
-
links(optional):
array links
Links
-
lockInfo(optional):
object ItemSubResourceLockInfo
Item SubResource.
-
metadata(optional):
object ItemMetadataInfo
ItemMetadataInfo
-
name(optional):
string
Name of the item. It is a required property in the get response and post/put request.
-
permissions(optional):
object ItemSubResourceListAction
Item SubResource.
-
publishedChannels(optional):
object ItemSubResourceListChannelId
Item SubResource.
-
publishInfo(optional):
object ItemSubResourceListPublishInfo
Item SubResource.
-
reference(optional):
object ItemReferenceInfo
ItemReferenceInfo
-
relationships(optional):
object ItemSubResourceRelationships
Item SubResource.
-
repositoryId(optional):
string
Repository of the item. It is a required property in the get response and post/put request.
-
scheduled(optional):
boolean
-
slug(optional):
string
URL slug of the item.
-
sourceId(optional):
string
Source Id.
-
status(optional):
string
Current status of the item.
-
suggestedTaxonomies(optional):
object ItemSubResourceListSuggestedTaxonomyInfo
Item SubResource.
-
tags(optional):
object ItemSubResourceListTag
Item SubResource.
-
taxonomies(optional):
object ItemSubResourceListTaxonomyInfo
Item SubResource.
-
translatable(optional):
boolean
Whether the item is translatable.
-
type(optional):
string
Name of the type. It is a required property in the get response and post/put request.
-
typeCategory(optional):
string
Read Only:
true
-
updatedBy(optional):
string
Updated by.
-
updatedByUser(optional):
object User
User object
-
updatedDate(optional):
object date
date
-
variations(optional):
object ItemSubResourceListVariationsInfo
Item SubResource.
-
version(optional):
string
The current revision version of this item.
-
versionInfo(optional):
object ItemSubResourceListVersionInfo
Item SubResource.
-
video(optional):
object VideoBean
VideoBean
-
workflowInstances(optional):
object WorkflowField
All mapped workflow fields
-
workflows(optional):
object ItemSubResourceListWorkflowInfo
Item SubResource.
Nested Schema : User
Type:
object
User object
Show Source
-
displayName(optional):
string
Read Only:
true
display name of the user. -
email(optional):
string
Read Only:
true
email of the user. -
userID(optional):
integer(int64)
Read Only:
true
id of the user. -
userName(optional):
string
Read Only:
true
name of the user.
Nested Schema : fields
Type:
object
Read Only:
true
Additional Properties Allowed
Show Source
User-defined fields data. Map. All the user-defined fields required in the type definition must be provided under this property in PUT and POST request.
Nested Schema : ItemMetadataInfo
Type:
object
ItemMetadataInfo
Show Source
-
exif(optional):
object EXIFMetadata
EXIF Metadata
-
links(optional):
array links
Links
-
transcripts(optional):
object VideoTranscriptMetadata
Video Transcription Metadata
Nested Schema : ItemReferenceInfo
Type:
object
ItemReferenceInfo
Show Source
-
isAccessible(optional):
boolean
Whether the item is accessible.
Nested Schema : VideoBean
Type:
object
VideoBean
Show Source
-
duration(optional):
string
Read Only:
true
The duration of the video in ISO 8601 format. -
isFormatSupported(optional):
boolean
Read Only:
true
A boolean expressing if the video file format is supported. -
playback(optional):
object PlaybackBean
PlaybackBean
-
processing(optional):
object ProcessingBean
ProcessingBean
-
strip(optional):
object StripBean
StripBean
Nested Schema : WorkflowField
Type:
object
All mapped workflow fields
Show Source
-
aggregationResults(optional):
array aggregationResults
Aggregation results.
-
count(optional):
integer(int32)
Total number of records in the current response.
-
hasMore(optional):
boolean
Check whether there are more pages to fetch.
-
items(optional):
array items
Singular resources contained in the collection.
-
limit(optional):
integer(int32)
Actual page size used by the server. This might not be the same as what the client requests.
-
links(optional):
array links
Links of the resource.
-
offset(optional):
integer(int32)
The actual index from which the singular resources are returned.
-
pinned(optional):
array pinned
Pinned items. Shows items pinned at the top of search list
-
scrollId(optional):
string
scrollId if the search resolved to a scroll search.
-
totalResults(optional):
integer(int32)
Total number of rows that satisfy the client request (excluding the paging parameters.)
Nested Schema : ChangesInfo
Type:
object
ChangesInfo
Show Source
-
links(optional):
array links
-
source(optional):
string
Sub-resource associated to this item which is source of this change.
-
type(optional):
string
Type of change tracked for the given source.
-
value(optional):
boolean
True indicates a change. False indicates no current changes for this source/type.
Nested Schema : ChannelId
Type:
object
ChannelId
Show Source
-
id(optional):
string
-
isPrimaryChannel(optional):
boolean
Indicates if channel is primary for an asset.
-
links(optional):
array links
Links
-
name(optional):
string
Nested Schema : ConnectorFileInfo
Type:
object
ConnectorFileInfo
Show Source
-
connectorId(optional):
string
Connector id.
-
id(optional):
string
File id.
-
inUse(optional):
boolean
Represents whether the latest version of asset is using the file content.
-
version(optional):
integer(int32)
File version
Nested Schema : additionalProperties
Type:
object
Nested Schema : LockInfo
Type:
object
LockInfo
Show Source
-
isLocked(optional):
boolean
Represents whether the item is locked or not.
-
lockedBy(optional):
string
Locked by user
-
lockedDate(optional):
object date
date
Nested Schema : EXIFMetadata
Type:
object
EXIF Metadata
Show Source
-
aggregationResults(optional):
array aggregationResults
Aggregation results.
-
count(optional):
integer(int32)
Total number of records in the current response.
-
hasMore(optional):
boolean
Check whether there are more pages to fetch.
-
items(optional):
array items
Singular resources contained in the collection.
-
limit(optional):
integer(int32)
Actual page size used by the server. This might not be the same as what the client requests.
-
links(optional):
array links
Links of the resource.
-
offset(optional):
integer(int32)
The actual index from which the singular resources are returned.
-
pinned(optional):
array pinned
Pinned items. Shows items pinned at the top of search list
-
scrollId(optional):
string
scrollId if the search resolved to a scroll search.
-
totalResults(optional):
integer(int32)
Total number of rows that satisfy the client request (excluding the paging parameters.)
Nested Schema : VideoTranscriptMetadata
Type:
object
Video Transcription Metadata
Show Source
-
aggregationResults(optional):
array aggregationResults
Aggregation results.
-
count(optional):
integer(int32)
Total number of records in the current response.
-
hasMore(optional):
boolean
Check whether there are more pages to fetch.
-
items(optional):
array items
Singular resources contained in the collection.
-
limit(optional):
integer(int32)
Actual page size used by the server. This might not be the same as what the client requests.
-
links(optional):
array links
Links of the resource.
-
offset(optional):
integer(int32)
The actual index from which the singular resources are returned.
-
pinned(optional):
array pinned
Pinned items. Shows items pinned at the top of search list
-
scrollId(optional):
string
scrollId if the search resolved to a scroll search.
-
totalResults(optional):
integer(int32)
Total number of rows that satisfy the client request (excluding the paging parameters.)
Nested Schema : items
Type:
array
Singular resources contained in the collection.
Show Source
-
Array of:
object ItemExtractedExifBean
ItemExtractedExifBean
Nested Schema : links
Type:
array
Links of the resource.
Show Source
-
Array of:
object Link
Link of the resource.
Nested Schema : pinned
Type:
array
Pinned items. Shows items pinned at the top of search list
Show Source
Nested Schema : ItemExtractedExifBean
Type:
object
ItemExtractedExifBean
Show Source
-
floatValue(optional):
number(float)
The float value of the EXIF field. This value will be a numeric representation of the EXIF field value with decimal precision.
-
handle(optional):
string
The handle or EXIF field name. This value is not translatable.
-
integerValue(optional):
integer(int32)
The integer value of the EXIF field. This value will be a numeric representation of the EXIF field value without a decimal point.
-
links(optional):
array links
Links
-
rawId(optional):
string
The ID of the EXIF field. Uniquely identifies one EXIF field.
-
rawValue(optional):
string
The raw EXIF field value. This value can be a numeric value out of a predefined value list or a text value.
-
stringValue(optional):
string
The text value of the EXIF field. This value will be a text representation of the EXIF field value.
-
type(optional):
string
The data type of the EXIF field. (date, integer, float, string).
-
value(optional):
string
The display value of the EXIF field. This value will be a text representation of the actual type value of the EXIF field (date, int, float, string).
Nested Schema : items
Type:
array
Singular resources contained in the collection.
Show Source
-
Array of:
object Videotranscript
Video transcript
Nested Schema : links
Type:
array
Links of the resource.
Show Source
-
Array of:
object Link
Link of the resource.
Nested Schema : pinned
Type:
array
Pinned items. Shows items pinned at the top of search list
Show Source
Nested Schema : Videotranscript
Type:
object
Video transcript
Show Source
-
end(optional):
string
End of each transcript node.
-
id(optional):
string
Id of each transcript node.
-
links(optional):
array links
Links
-
start(optional):
string
Start of each transcript node.
-
text(optional):
string
Text of each transcript node.
Nested Schema : Action
Type:
object
Action
Show Source
-
action(optional):
string
Allowed Values:
[ "view", "update", "create", "delete" ]
action is allowed on the resource
Nested Schema : PublishInfo
Type:
object
PublishInfo
Show Source
-
channel(optional):
string
Target name
-
links(optional):
array links
Links
-
publishedBy(optional):
string
Published by
-
publishedDate(optional):
object date
date
-
slug(optional):
string
Published slug
-
version(optional):
string
Published version
Nested Schema : Relationships
Type:
object
Relationships
Show Source
-
referencedBy(optional):
array referencedBy
Referenced by ids
-
referencedBySitePlan(optional):
object Siteplanreference
Site plan reference
-
referencedBySites(optional):
array referencedBySites
Referenced by sites
-
references(optional):
array references
Reference ids
Nested Schema : referencedBy
Type:
array
Referenced by ids
Show Source
-
Array of:
object References
References
Nested Schema : Siteplanreference
Type:
object
Site plan reference
Show Source
-
id(optional):
string
id of the site plan.
-
links(optional):
array links
Nested Schema : referencedBySites
Type:
array
Referenced by sites
Show Source
-
Array of:
object ReferencedBySites
ReferencedBySites
Nested Schema : references
Type:
array
Reference ids
Show Source
-
Array of:
object References
References
Nested Schema : References
Type:
object
References
Show Source
-
id(optional):
string
id of the item.
-
links(optional):
array links
-
reference(optional):
object ItemReferenceInfo
ItemReferenceInfo
Nested Schema : ReferencedBySites
Type:
object
ReferencedBySites
Show Source
-
component(optional):
string
Component of the item
-
pageId(optional):
string
Page the item added to
-
site(optional):
string
Site the item added to
Nested Schema : data
Type:
Show Source
array
-
Array of:
object SuggestedTaxonomyInfo
SuggestedTaxonomyInfo
Nested Schema : SuggestedTaxonomyInfo
Type:
object
SuggestedTaxonomyInfo
Show Source
-
categories(optional):
array categories
Categories in the Suggested Taxonomy the item belongs to.
-
id(optional):
string
-
links(optional):
array links
-
name(optional):
string
-
shortName(optional):
string
Nested Schema : categories
Type:
array
Categories in the Suggested Taxonomy the item belongs to.
Show Source
Nested Schema : ItemSuggestedCategoryInfo
Type:
Show Source
object
-
apiName(optional):
string
The apiName of the category assigned to the item.
-
id(optional):
string
-
isRejected(optional):
boolean
Status of the Suggested Category for the Item.
-
links(optional):
array links
-
name(optional):
string
-
nodes(optional):
array nodes
Nodes in the category assigned to the item.
-
order(optional):
integer(int32)
Probability order of the Suggested Category across all the Taxonomies assigned to the repository.
Nested Schema : Tag
Type:
object
Tag.
Show Source
-
language:
string
language of the tag.
-
links(optional):
array links
Links
-
name:
string
Name of the tag.
Nested Schema : TaxonomyInfo
Type:
object
TaxonomyInfo
Show Source
-
categories(optional):
array categories
Categories in the Taxonomy the item belongs to.
-
id(optional):
string
-
links(optional):
array links
-
name(optional):
string
-
shortName(optional):
string
Nested Schema : ItemCategoryInfo
Type:
Show Source
object
-
apiName(optional):
string
The apiName of the category assigned to the item.
-
id(optional):
string
-
links(optional):
array links
-
name(optional):
string
-
nodes(optional):
array nodes
Nodes in the category assigned to the item.
Nested Schema : VariationsInfo
Type:
object
Variations Info.
Show Source
-
items(optional):
array items
Content item variations.
-
links(optional):
array links
-
masterItem(optional):
string
Master item.
-
setId(optional):
string
Variation set id.
-
varType(optional):
string
Variation type name.
Nested Schema : items
Type:
array
Content item variations.
Show Source
-
Array of:
object Language
LanguageItem
Nested Schema : Language
Type:
object
LanguageItem
Show Source
-
id(optional):
string
id of the item.
-
isPublished(optional):
boolean
Whether the item is ever published.
-
links(optional):
array links
-
name(optional):
string
name of the item.
-
status(optional):
string
status of item
-
value(optional):
string
Language value
Nested Schema : VersionInfo
Type:
object
VersionInfo
Show Source
-
latestVersion(optional):
string
Latest version
-
publishedVersion(optional):
string
Published version
Nested Schema : PlaybackBean
Type:
object
PlaybackBean
Show Source
-
adaptiveStreams(optional):
object AdaptiveStreamsBean
AdaptiveStreamsBean
Nested Schema : ProcessingBean
Type:
object
ProcessingBean
Show Source
-
progress(optional):
string
Read Only:
true
The progress of the background process. The value of this field will be one of PENDING, SUCCEEDED or FAILED.
Nested Schema : StripBean
Type:
object
StripBean
Show Source
-
frame(optional):
object StripFrameBean
StripFrameBean
Nested Schema : AdaptiveStreamsBean
Type:
object
AdaptiveStreamsBean
Show Source
-
dash(optional):
object PlaybackBean
PlaybackBean
-
hls(optional):
object PlaybackBean
PlaybackBean
Nested Schema : StripFrameBean
Type:
object
StripFrameBean
Show Source
-
count(optional):
integer(int32)
Read Only:
true
The number of frames in the strip image. -
height(optional):
integer(int32)
Read Only:
true
The height of the strip image. -
width(optional):
integer(int32)
Read Only:
true
The width of the strip image.
Nested Schema : items
Type:
array
Singular resources contained in the collection.
Show Source
-
Array of:
object WorkflowInfo
WorkflowInfo.
Nested Schema : links
Type:
array
Links of the resource.
Show Source
-
Array of:
object Link
Link of the resource.
Nested Schema : pinned
Type:
array
Pinned items. Shows items pinned at the top of search list
Show Source
Nested Schema : WorkflowInfo
Type:
object
WorkflowInfo.
Show Source
-
id(optional):
string
Workflow id.
-
instanceId:
string
Workflow instance id.
-
isCompleted(optional):
boolean
If workflow instance is completed or not in OIC.
-
links(optional):
array links
Links
-
name(optional):
string
Workflow name.
-
status(optional):
string
Workflow status.
-
submittedBy(optional):
string
Submitted by user
-
submittedDate(optional):
object date
date
400 Response
Bad request.
403 Response
Forbidden.
404 Response
The requested resource was not found.
409 Response
The requested resource operation is temporarily unavailable
500 Response
Internal server error.
Examples
The following examples show how to update the existing categories by submitting a PUT request on the REST resource using cURL.
curl -X PUT -H 'Content-Type: application/json' -H 'X-Requested-With: XMLHttpRequest' 'https://host:port/content/management/api/v1.1/taxonomies/{id}/categories/{categoryID}?q=(status eq \"draft\")'
Example 1:
This updates the name and position of the category.
/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories/35B41502F9A94113AC493C244794D2AC?q=(status eq \"draft\")
Request Body
{ "name": "New name", "position": 1 }
Example 2:
This updates the description of the category.
/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories/35B41502F9A94113AC493C244794D2AC?q=(status eq \"draft\")
Request Body
{ "name": "New name", "description": "The new description." }
Example 3:
This example shows how to move a category and all its descendants to the root level by setting the parent Id to the taxonomy ID.
/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories/35B41502F9A94113AC493C244794D2AC?q=(status eq \"draft\")
Request Body
{ "name": "New name", "parentId": "D7969D6CA0D144AEA9CCA88BA6D2CF81" }