Search categories
/content/management/api/v1.1/taxonomies/{id}/categories
Filtering while traversing the taxonomy tree:
Category search is performed within a single taxonomy. It is possible to limit the number of categories returned, check total number of matching categories towards a query, filter category fields in the results and/or sort categories by supported fields.
Filtering on Suggested Items:
All promoted categories in the taxonomy which have Suggested Items will be returned. Refer to the query syntax description to see the limitations.
Request
-
id: string
id of the taxonomy.
-
default(optional): string
Default search query expression.
-
expand(optional): string
Expand parameter provides the option of getting sub-resources inline with the category's response. Accepts a comma-separated list of field names. Field names are case-sensitive.When the expand parameter contains a nonexistent field as per type definition of the requested category, the resource produces HTTP 400.
Examples :- expand=suggestedItems
-
fields(optional): string
The fields parameter is used to control the returned fields and values in the queried category. This parameter accepts a comma-separated list of field names or all. These fields will be returned for each queried category. All the field names are case-sensitive. When fields is specified as all (in lower case), all the standard fields and optional fields are returned for each category. Each category has both standard fields (id, name, apiName, description, parent, parentId, position, status) and optional fields (ancestors, children, isSiteCategory and roleName). If the field children is requested, each category will return with their respective children count followed by a link to fully expand their children categories (full expansion is not supported within search operation). The standard field id is always returned in the response and cannot be filtered out. This parameter is optional in the query and by default query result shows only id, name, description, apiName, status, position, parentId in the response. Any incorrect or invalid field name given will result in an error.
Example: ?q=(name co "car")&fields=name,description,parent,ancestors
This returns id, name, description, parent and ancestors in the search results for a category containing "car" in the name field.
Example: ?q=(roleName eq "editor")&fields=roleName
This returns id, roleName in the search results for a category matching taxonomy permissions with "editor" or higher roles.
Example: ?fields=name,parent
This will return only standard fields (such as id, name and parent) for all categories within the default limit.
Example: ?fields=name,children
This will return fields: id, name and children count for all categories within the default limit.Default Value:name,description,apiName,status,position,parentId
-
limit(optional): integer(int32)
This parameter accepts a non negative integer and is used to control the size of the result.Default Value:
100
-
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, first, last, prev, next
-
offset(optional): integer(int32)
This parameter accepts a non negative integer and is used to control the start index of the result.Default Value:
0
-
orderBy(optional): string
This parameter is used to control order of results. The value of this query parameter follow the format of fieldName:[asc/desc]. asc stands for ascending order desc stands for descending order.
Allowed fields while traversing the taxonomy tree are name and position. The default sort order is asc.
Allowed fields while filtering on Suggested Items are name, namePath and suggestedItems.totalResults. The default sort order is desc. -
q(optional): string
This parameter accepts a query expression condition that matches the field values. Many query conditions can be joined using AND/OR operators and grouped with parentheses. The value of the query condition follows the format of {fieldName} {operator} "{fieldValue}"
Filtering while traversing the taxonomy tree:
The only field names supported are status, parent.id, parentId, id, name, and apiName. If no value is provided for status it defaults to "promoted". The field parentId is a legacy field and it is interchangeable with parent.id.
When a parentId or parent.id is provided, only categories with that parent id will be listed. If no parentId is provided, categories from all levels will be returned in the list. The valid operator is eq.
When a id is provided, categories matching the criteria will be returned. The valid operator is eq.
When a name is provided, categories matching the criteria will be returned. The valid operators are eq, sw, and co.
When an apiName is provided, categories matching the criteria will be returned. The valid operator is eq.
When an ancestors.id is provided, categories with an ancestor matching the criteria will be returned. The valid operator is eq.
When an ancestors.name is provided, categories with an ancestor matching the criteria will be returned. The valid operators are eq, sw, and co.
When an ancestors.apiName is provided, categories with an ancestor matching the criteria will be returned. The valid operator is eq.
When an roleName is provided, categories with taxonomy permission matching the criteria will be returned. The valid operator is eq.
When updating a category the query parameter should always be provided with status set to "draft" as the default status is "promoted" and a promoted category cannot be modified.
Example:
https://{cecsdomain}/content/management/api/v1.1/taxonomies/{id}/categories?q=(status eq "draft")
Example:
https://{cecsdomain}/content/management/api/v1.1/taxonomies/{id}/categories?q=(status eq "promoted" and parent.id eq "DJGSAFWEGSSADWDFEWG235F")
Example:
https://{cecsdomain}/content/management/api/v1.1/taxonomies/{id}/categories?q=(status eq "promoted" and id eq "DJGSAFWEGSSADWDFEWG235F")
Example:
https://{cecsdomain}/content/management/api/v1.1/taxonomies/{id}/categories?q=(status eq "promoted" and name sw "car")
Example:
https://{cecsdomain}/content/management/api/v1.1/taxonomies/{id}/categories?q=(status eq "promoted" and apiName eq "AAAA")
Example:
https://{cecsdomain}/content/management/api/v1.1/taxonomies/{id}/categories?q=(status eq "promoted" and ancestors.id eq "DJGSAFWEGSSADWDFEWG235F")
Example:
https://{cecsdomain}/content/management/api/v1.1/taxonomies/{id}/categories?q=(status eq "promoted" and ancestors.name sw "car")
Example:
https://{cecsdomain}/content/management/api/v1.1/taxonomies/{id}/categories?q=(status eq "promoted" and ancestors.apiName eq "AAAA")
Filtering on Suggested Items:
The only fields supported are suggestedItems.repositoryId, suggestedItems.suggestedTaxonomies.categories.isRejected, suggestedItems.language and name.
suggestedItems.repositoryId filter is mandatory while filtering for categories with Suggested Items.
Example: Get all categories with Suggested Items in all languages:
https://{cecsdomain}/content/management/api/v1.1/taxonomies/{id}/categories?q=(suggestedItems.repositoryId eq "55217949D4764305A4634FA9CC99E848") AND (suggestedItems.suggestedTaxonomies.categories.isRejected eq "false"))&expand=suggestedItems&suggestedItems:totalResults=true&orderBy=suggestedItems.totalResults:desc
Example: Get all categories with Suggested Items in a given language:
https://{cecsdomain}/content/management/api/v1.1/taxonomies/{id}/categories?q=(suggestedItems.repositoryId eq "55217949D4764305A4634FA9CC99E848") AND (suggestedItems.suggestedTaxonomies.categories.isRejected eq "false") AND (suggestedItems.language co "en-US")&expand=suggestedItems&suggestedItems:totalResults=true&orderBy=suggestedItems.totalResults:desc
Example: Get all categories with rejected Suggested Items in a given language:
https://{cecsdomain}/content/management/api/v1.1/taxonomies/{id}/categories?q=(suggestedItems.repositoryId eq "55217949D4764305A4634FA9CC99E848") AND (suggestedItems.suggestedTaxonomies.categories.isRejected eq "true") AND (suggestedItems.language co "en-US")&expand=suggestedItems&suggestedItems:totalResults=true&orderBy=suggestedItems.totalResults:desc -
totalResults(optional): boolean
This parameter accepts a boolean flag. If specified as true, then the returned result must include the total result count.Default Value:
false
Response
- application/json
200 Response
object
-
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.)
array
-
Array of:
object CategoryInCollection
Category in Collection Response
array
-
Array of:
object Link
Link of the resource.
array
object
-
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.
object
object
-
values(optional):
array values
The list of values of the custom property.
object
-
id(optional):
string
Read Only:
true
The id of the custom property value. -
value(optional):
string
The value of the custom property.
object
-
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.
object
-
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
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.
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.
object
typeCategory
-
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.
object
-
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.
object
true
object
-
exif(optional):
object EXIFMetadata
EXIF Metadata
-
links(optional):
array links
Links
-
transcripts(optional):
object VideoTranscriptMetadata
Video Transcription Metadata
object
-
isAccessible(optional):
boolean
Whether the item is accessible.
object
-
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
object
-
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.)
object
-
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.
object
-
id(optional):
string
-
isPrimaryChannel(optional):
boolean
Indicates if channel is primary for an asset.
-
links(optional):
array links
Links
-
name(optional):
string
object
-
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
object
object
-
isLocked(optional):
boolean
Represents whether the item is locked or not.
-
lockedBy(optional):
string
Locked by user
-
lockedDate(optional):
object date
date
object
-
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.)
object
-
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.)
array
-
Array of:
object ItemExtractedExifBean
ItemExtractedExifBean
array
-
Array of:
object Link
Link of the resource.
array
object
-
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).
array
-
Array of:
object Videotranscript
Video transcript
array
-
Array of:
object Link
Link of the resource.
array
object
-
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.
object
-
action(optional):
string
Allowed Values:
[ "view", "update", "create", "delete" ]
action is allowed on the resource
object
-
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
object
-
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
array
-
Array of:
object References
References
object
-
id(optional):
string
id of the site plan.
-
links(optional):
array links
array
-
Array of:
object ReferencedBySites
ReferencedBySites
array
-
Array of:
object References
References
object
-
id(optional):
string
id of the item.
-
links(optional):
array links
-
reference(optional):
object ItemReferenceInfo
ItemReferenceInfo
object
-
component(optional):
string
Component of the item
-
pageId(optional):
string
Page the item added to
-
site(optional):
string
Site the item added to
array
-
Array of:
object SuggestedTaxonomyInfo
SuggestedTaxonomyInfo
object
-
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
array
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.
object
-
language:
string
language of the tag.
-
links(optional):
array links
Links
-
name:
string
Name of the tag.
object
-
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
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.
object
-
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.
array
-
Array of:
object Language
LanguageItem
object
-
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
object
-
latestVersion(optional):
string
Latest version
-
publishedVersion(optional):
string
Published version
object
-
adaptiveStreams(optional):
object AdaptiveStreamsBean
AdaptiveStreamsBean
object
-
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.
object
-
frame(optional):
object StripFrameBean
StripFrameBean
object
-
dash(optional):
object PlaybackBean
PlaybackBean
-
hls(optional):
object PlaybackBean
PlaybackBean
object
-
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.
array
-
Array of:
object WorkflowInfo
WorkflowInfo.
array
-
Array of:
object Link
Link of the resource.
array
object
-
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
403 Response
404 Response
500 Response
Examples
The following examples show how to fetch the categories of a taxonomy by submitting a GET request using cURL:
curl -X GET -H 'Accept: application/json' 'https://host:port/content/management/api/v1.1/taxonomies/{id}/categories'
Example 1:
This returns all the categories on the root level of the taxonomy.
/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories?q=(status eq \"draft\")
Response Body
{ "hasMore": false, "offset": 0, "count": 4, "limit": 100, "items": [ { "id": "35B41502F9A94113AC493C244794D2AC", "name": "C1", "description": "", "status": "draft", "position": 0, "parentId": "D7969D6CA0D144AEA9CCA88BA6D2CF81", "links": [ { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories/35B41502F9A94113AC493C244794D2AC?q=( status eq \"draft\" )", "rel": "self", "method": "GET", "mediaType": "application/json" } ] }, { "id": "AFD4C8E11C1D442B88A51B20E78BB0A6", "name": "C2", "description": "", "status": "draft", "position": 1, "parentId": "D7969D6CA0D144AEA9CCA88BA6D2CF81", "links": [ { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories/AFD4C8E11C1D442B88A51B20E78BB0A6?q=( status eq \"draft\" )", "rel": "self", "method": "GET", "mediaType": "application/json" } ] }, { "id": "F907C89628AE44D4A253EC3DCB6EC987", "name": "C3", "description": "", "status": "draft", "position": 2, "parentId": "D7969D6CA0D144AEA9CCA88BA6D2CF81", "links": [ { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories/F907C89628AE44D4A253EC3DCB6EC987?q=( status eq \"draft\" )", "rel": "self", "method": "GET", "mediaType": "application/json" } ] }, { "id": "B0A39B47122C4CE88A6CD52B90C15263", "name": "C4", "description": "", "status": "draft", "position": 3, "parentId": "D7969D6CA0D144AEA9CCA88BA6D2CF81", "links": [ { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories/B0A39B47122C4CE88A6CD52B90C15263?q=( status eq \"draft\" )", "rel": "self", "method": "GET", "mediaType": "application/json" } ] } ], "links": [ { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories?q=(status eq \"draft\")", "rel": "self", "method": "GET", "mediaType": "application/json" }, { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories?q=(status eq \"draft\")", "rel": "canonical", "method": "GET", "mediaType": "application/json" }, { "href": "https://<hostname>/content/management/api/v1.1/metadata-catalog/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories", "rel": "describedby", "method": "GET", "mediaType": "application/schema+json" }, { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories?offset=0&q=(status eq \"draft\")", "rel": "first", "method": "GET", "mediaType": "application/json" }, { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories?offset=0&q=(status eq \"draft\")", "rel": "last", "method": "GET", "mediaType": "application/json" } ] }
Example 2:
This returns the root categories in the taxonomy from offset 1.
/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories?q=(status eq \"draft\")&offset=1
Response Body
{ "hasMore": false, "offset": 1, "count": 3, "limit": 100, "items": [ { "id": "AFD4C8E11C1D442B88A51B20E78BB0A6", "name": "C2", "description": "", "status": "draft", "position": 1, "parentId": "D7969D6CA0D144AEA9CCA88BA6D2CF81", "links": [ { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories/AFD4C8E11C1D442B88A51B20E78BB0A6?q=( status eq \"draft\" )", "rel": "self", "method": "GET", "mediaType": "application/json" } ] }, { "id": "F907C89628AE44D4A253EC3DCB6EC987", "name": "C3", "description": "", "status": "draft", "position": 2, "parentId": "D7969D6CA0D144AEA9CCA88BA6D2CF81", "links": [ { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories/F907C89628AE44D4A253EC3DCB6EC987?q=( status eq \"draft\" )", "rel": "self", "method": "GET", "mediaType": "application/json" } ] }, { "id": "B0A39B47122C4CE88A6CD52B90C15263", "name": "C4", "description": "", "status": "draft", "position": 3, "parentId": "D7969D6CA0D144AEA9CCA88BA6D2CF81", "links": [ { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories/B0A39B47122C4CE88A6CD52B90C15263?q=( status eq \"draft\" )", "rel": "self", "method": "GET", "mediaType": "application/json" } ] } ], "links": [ { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories?offset=1&q=(status eq \"draft\")", "rel": "self", "method": "GET", "mediaType": "application/json" }, { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories?offset=1&q=(status eq \"draft\")", "rel": "canonical", "method": "GET", "mediaType": "application/json" }, { "href": "https://<hostname>/content/management/api/v1.1/metadata-catalog/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories", "rel": "describedby", "method": "GET", "mediaType": "application/schema+json" }, { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories?offset=0&q=(status eq \"draft\")", "rel": "prev", "method": "GET", "mediaType": "application/json" }, { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories?offset=0&q=(status eq \"draft\")", "rel": "first", "method": "GET", "mediaType": "application/json" }, { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories?offset=1&q=(status eq \"draft\")", "rel": "last", "method": "GET", "mediaType": "application/json" } ] }
Example 3:
This returns the root categories in the taxonomy from offset 1 for a maximum of 2 items.
/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories?q=(status eq \"draft\")&offset=1&limit=2
Response Body
{ "hasMore": true, "offset": 1, "count": 2, "limit": 2, "items": [ { "id": "AFD4C8E11C1D442B88A51B20E78BB0A6", "name": "C2", "description": "", "status": "draft", "position": 1, "parentId": "D7969D6CA0D144AEA9CCA88BA6D2CF81", "links": [ { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories/AFD4C8E11C1D442B88A51B20E78BB0A6?q=( status eq \"draft\" )", "rel": "self", "method": "GET", "mediaType": "application/json" } ] }, { "id": "F907C89628AE44D4A253EC3DCB6EC987", "name": "C3", "description": "", "status": "draft", "position": 2, "parentId": "D7969D6CA0D144AEA9CCA88BA6D2CF81", "links": [ { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories/F907C89628AE44D4A253EC3DCB6EC987?q=( status eq \"draft\" )", "rel": "self", "method": "GET", "mediaType": "application/json" } ] } ], "links": [ { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories?limit=2&q=(status eq \"draft\")&offset=1", "rel": "self", "method": "GET", "mediaType": "application/json" }, { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories?limit=2&q=(status eq \"draft\")&offset=1", "rel": "canonical", "method": "GET", "mediaType": "application/json" }, { "href": "https://<hostname>/content/management/api/v1.1/metadata-catalog/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories", "rel": "describedby", "method": "GET", "mediaType": "application/schema+json" }, { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories?limit=2&q=(status eq \"draft\")&offset=0", "rel": "prev", "method": "GET", "mediaType": "application/json" }, { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories?limit=2&q=(status eq \"draft\")&offset=3", "rel": "next", "method": "GET", "mediaType": "application/json" }, { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories?limit=2&q=(status eq \"draft\")&offset=0", "rel": "first", "method": "GET", "mediaType": "application/json" }, { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories?limit=2&q=(status eq \"draft\")&offset=3", "rel": "last", "method": "GET", "mediaType": "application/json" } ] }
Example 4:
This returns the root categories from offset 1, limit 2, including the total available results.
/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories?q=(status eq \"draft\")&offset=1&limit=2&totalResults=true
Response Body
{ "hasMore": true, "offset": 1, "count": 2, "limit": 2, "totalResults": 4, "items": [ { "id": "AFD4C8E11C1D442B88A51B20E78BB0A6", "name": "C2", "description": "", "status": "draft", "position": 1, "parentId": "D7969D6CA0D144AEA9CCA88BA6D2CF81", "links": [ { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories/AFD4C8E11C1D442B88A51B20E78BB0A6?q=( status eq \"draft\" )", "rel": "self", "method": "GET", "mediaType": "application/json" } ] }, { "id": "F907C89628AE44D4A253EC3DCB6EC987", "name": "C3", "description": "", "status": "draft", "position": 2, "parentId": "D7969D6CA0D144AEA9CCA88BA6D2CF81", "links": [ { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories/F907C89628AE44D4A253EC3DCB6EC987?q=( status eq \"draft\" )", "rel": "self", "method": "GET", "mediaType": "application/json" } ] } ], "links": [ { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories?limit=2&q=(status eq \"draft\")&totalResults=true&offset=1", "rel": "self", "method": "GET", "mediaType": "application/json" }, { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories?limit=2&q=(status eq \"draft\")&totalResults=true&offset=1", "rel": "canonical", "method": "GET", "mediaType": "application/json" }, { "href": "https://<hostname>/content/management/api/v1.1/metadata-catalog/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories", "rel": "describedby", "method": "GET", "mediaType": "application/schema+json" }, { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories?limit=2&q=(status eq \"draft\")&totalResults=true&offset=0", "rel": "prev", "method": "GET", "mediaType": "application/json" }, { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories?limit=2&q=(status eq \"draft\")&totalResults=true&offset=3", "rel": "next", "method": "GET", "mediaType": "application/json" }, { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories?limit=2&q=(status eq \"draft\")&totalResults=true&offset=0", "rel": "first", "method": "GET", "mediaType": "application/json" }, { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories?limit=2&q=(status eq \"draft\")&totalResults=true&offset=3", "rel": "last", "method": "GET", "mediaType": "application/json" } ] }
Example 5:
This returns the root categories of the promoted taxonomies.
/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories
Response Body
{ "hasMore": false, "offset": 0, "count": 4, "limit": 100, "items": [ { "id": "35B41502F9A94113AC493C244794D2AC", "name": "C1", "description": "", "status": "promoted", "position": 0, "parentId": "D7969D6CA0D144AEA9CCA88BA6D2CF81", "links": [ { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories/35B41502F9A94113AC493C244794D2AC", "rel": "self", "method": "GET", "mediaType": "application/json" } ] }, { "id": "AFD4C8E11C1D442B88A51B20E78BB0A6", "name": "C2", "description": "", "status": "promoted", "position": 1, "parentId": "D7969D6CA0D144AEA9CCA88BA6D2CF81", "links": [ { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories/AFD4C8E11C1D442B88A51B20E78BB0A6", "rel": "self", "method": "GET", "mediaType": "application/json" } ] }, { "id": "F907C89628AE44D4A253EC3DCB6EC987", "name": "C3", "description": "", "status": "promoted", "position": 2, "parentId": "D7969D6CA0D144AEA9CCA88BA6D2CF81", "links": [ { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories/F907C89628AE44D4A253EC3DCB6EC987", "rel": "self", "method": "GET", "mediaType": "application/json" } ] }, { "id": "B0A39B47122C4CE88A6CD52B90C15263", "name": "C4", "description": "", "status": "promoted", "position": 3, "parentId": "D7969D6CA0D144AEA9CCA88BA6D2CF81", "links": [ { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories/B0A39B47122C4CE88A6CD52B90C15263", "rel": "self", "method": "GET", "mediaType": "application/json" } ] } ], "links": [ { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories", "rel": "self", "method": "GET", "mediaType": "application/json" }, { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories", "rel": "canonical", "method": "GET", "mediaType": "application/json" }, { "href": "https://<hostname>/content/management/api/v1.1/metadata-catalog/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories", "rel": "describedby", "method": "GET", "mediaType": "application/schema+json" }, { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories?offset=0", "rel": "first", "method": "GET", "mediaType": "application/json" }, { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories?offset=0", "rel": "last", "method": "GET", "mediaType": "application/json" } ] }
Example 6:
This returns the draft-child categories of the parent specified in the parentId query parameter.
/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories?q=(status eq \"draft\" and parentId eq \"35B41502F9A94113AC493C244794D2AC\")
Response Body
{ "hasMore": false, "offset": 0, "count": 3, "limit": 100, "items": [ { "id": "C52EE14C1CB34A95ACC9CDC3CF8BE289", "name": "C1.1", "description": "", "status": "draft", "position": 0, "parentId": "35B41502F9A94113AC493C244794D2AC", "links": [ { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories/C52EE14C1CB34A95ACC9CDC3CF8BE289?q=( status eq \"draft\" )", "rel": "self", "method": "GET", "mediaType": "application/json" } ] }, { "id": "36C51840F39A436B8F64A6DC5BC4C3B7", "name": "C1.2", "description": "", "status": "draft", "position": 1, "parentId": "35B41502F9A94113AC493C244794D2AC", "links": [ { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories/36C51840F39A436B8F64A6DC5BC4C3B7?q=( status eq \"draft\" )", "rel": "self", "method": "GET", "mediaType": "application/json" } ] }, { "id": "D1C7F6E13A4A4AF4ABBF211635D6CB43", "name": "C1.3", "description": "", "status": "draft", "position": 2, "parentId": "35B41502F9A94113AC493C244794D2AC", "links": [ { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories/D1C7F6E13A4A4AF4ABBF211635D6CB43?q=( status eq \"draft\" )", "rel": "self", "method": "GET", "mediaType": "application/json" } ] } ], "links": [ { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories?q=(status eq \"draft\" and parentId eq \"35B41502F9A94113AC493C244794D2AC\")", "rel": "self", "method": "GET", "mediaType": "application/json" }, { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories?q=(status eq \"draft\" and parentId eq \"35B41502F9A94113AC493C244794D2AC\")", "rel": "canonical", "method": "GET", "mediaType": "application/json" }, { "href": "https://<hostname>/content/management/api/v1.1/metadata-catalog/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories", "rel": "describedby", "method": "GET", "mediaType": "application/schema+json" }, { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories?offset=0&q=(status eq \"draft\" and parentId eq \"35B41502F9A94113AC493C244794D2AC\")", "rel": "first", "method": "GET", "mediaType": "application/json" }, { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories?offset=0&q=(status eq \"draft\" and parentId eq \"35B41502F9A94113AC493C244794D2AC\")", "rel": "last", "method": "GET", "mediaType": "application/json" } ] }
Example 7:
This returns the child categories of the parent category specified in the parentId query parameter in a descending order.
/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories?q=(status eq \"draft\" and parentId eq \"35B41502F9A94113AC493C244794D2AC\")&orderBy=position:des
Response Body
{ "hasMore": false, "offset": 0, "count": 3, "limit": 100, "items": [ { "id": "D1C7F6E13A4A4AF4ABBF211635D6CB43", "name": "C1.3", "description": "", "status": "draft", "position": 2, "parentId": "35B41502F9A94113AC493C244794D2AC", "links": [ { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories/D1C7F6E13A4A4AF4ABBF211635D6CB43?q=( status eq \"draft\" )", "rel": "self", "method": "GET", "mediaType": "application/json" } ] }, { "id": "36C51840F39A436B8F64A6DC5BC4C3B7", "name": "C1.2", "description": "", "status": "draft", "position": 1, "parentId": "35B41502F9A94113AC493C244794D2AC", "links": [ { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories/36C51840F39A436B8F64A6DC5BC4C3B7?q=( status eq \"draft\" )", "rel": "self", "method": "GET", "mediaType": "application/json" } ] }, { "id": "C52EE14C1CB34A95ACC9CDC3CF8BE289", "name": "C1.1", "description": "", "status": "draft", "position": 0, "parentId": "35B41502F9A94113AC493C244794D2AC", "links": [ { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories/C52EE14C1CB34A95ACC9CDC3CF8BE289?q=( status eq \"draft\" )", "rel": "self", "method": "GET", "mediaType": "application/json" } ] } ], "links": [ { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories?orderBy=position:des&q=(status eq \"draft\" and parentId eq \"35B41502F9A94113AC493C244794D2AC\")", "rel": "self", "method": "GET", "mediaType": "application/json" }, { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories?orderBy=position:des&q=(status eq \"draft\" and parentId eq \"35B41502F9A94113AC493C244794D2AC\")", "rel": "canonical", "method": "GET", "mediaType": "application/json" }, { "href": "https://<hostname>/content/management/api/v1.1/metadata-catalog/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories", "rel": "describedby", "method": "GET", "mediaType": "application/schema+json" }, { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories?offset=0&orderBy=position:des&q=(status eq \"draft\" and parentId eq \"35B41502F9A94113AC493C244794D2AC\")", "rel": "first", "method": "GET", "mediaType": "application/json" }, { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories?offset=0&orderBy=position:des&q=(status eq \"draft\" and parentId eq \"35B41502F9A94113AC493C244794D2AC\")", "rel": "last", "method": "GET", "mediaType": "application/json" } ] }
Example 8:
This returns the root categories of the taxonomy ordered by name in a descending order.
/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories?orderBy=name:des
Response Body
{ "hasMore": false, "offset": 0, "count": 4, "limit": 100, "items": [ { "id": "B0A39B47122C4CE88A6CD52B90C15263", "name": "C4", "description": "", "status": "promoted", "position": 3, "parentId": "D7969D6CA0D144AEA9CCA88BA6D2CF81", "links": [ { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories/B0A39B47122C4CE88A6CD52B90C15263", "rel": "self", "method": "GET", "mediaType": "application/json" } ] }, { "id": "F907C89628AE44D4A253EC3DCB6EC987", "name": "C3", "description": "", "status": "promoted", "position": 2, "parentId": "D7969D6CA0D144AEA9CCA88BA6D2CF81", "links": [ { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories/F907C89628AE44D4A253EC3DCB6EC987", "rel": "self", "method": "GET", "mediaType": "application/json" } ] }, { "id": "AFD4C8E11C1D442B88A51B20E78BB0A6", "name": "C2", "description": "", "status": "promoted", "position": 1, "parentId": "D7969D6CA0D144AEA9CCA88BA6D2CF81", "links": [ { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories/AFD4C8E11C1D442B88A51B20E78BB0A6", "rel": "self", "method": "GET", "mediaType": "application/json" } ] }, { "id": "35B41502F9A94113AC493C244794D2AC", "name": "C1", "description": "", "status": "promoted", "position": 0, "parentId": "D7969D6CA0D144AEA9CCA88BA6D2CF81", "links": [ { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories/35B41502F9A94113AC493C244794D2AC", "rel": "self", "method": "GET", "mediaType": "application/json" } ] } ], "links": [ { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories?orderBy=name:des", "rel": "self", "method": "GET", "mediaType": "application/json" }, { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories?orderBy=name:des", "rel": "canonical", "method": "GET", "mediaType": "application/json" }, { "href": "https://<hostname>/content/management/api/v1.1/metadata-catalog/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories", "rel": "describedby", "method": "GET", "mediaType": "application/schema+json" }, { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories?offset=0&orderBy=name:des", "rel": "first", "method": "GET", "mediaType": "application/json" }, { "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categories?offset=0&orderBy=name:des", "rel": "last", "method": "GET", "mediaType": "application/json" } ] }
Example 9:
This returns all the categories with a specified set of fields under parent category F54C934D081B4768B3A93A45C0E6955C of taxonomy AF6B75DBBCA244FC93166610EA2BA62A.
/content/management/api/v1.1/taxonomies/AF6B75DBBCA244FC93166610EA2BA62A/categories?q=(parent.id eq \"F54C934D081B4768B3A93A45C0E6955C\")&fields=id,name,parent,isSiteCategory
Response Body
{ "hasMore": false, "offset": 0, "count": 2, "limit": 2, "items": [ { "id": "4136D8D1FD5C4241A3E08A42765D615C", "name": "Site1_site_category", "isSiteCategory": true, "parent": { "id": "F54C934D081B4768B3A93A45C0E6955C", "name": "team1", "apiName": "sst-o-d" }, "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/AF6B75DBBCA244FC93166610EA2BA62A/categories/4136D8D1FD5C4241A3E08A42765D615C", "rel": "self", "method": "GET", "mediaType": "application/json" } ] }, { "id": "3DDAED10146B434EA706F94380E13B07", "name": "subteam1", "isSiteCategory": false, "parent": { "id": "F54C934D081B4768B3A93A45C0E6955C", "name": "team1", "apiName": "sst-o-d" }, "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/AF6B75DBBCA244FC93166610EA2BA62A/categories/3DDAED10146B434EA706F94380E13B07", "rel": "self", "method": "GET", "mediaType": "application/json" } ] } ], "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/AF6B75DBBCA244FC93166610EA2BA62A/categories?fields=id,name,parent,isSiteCategory&q=(parent.id eq \"F54C934D081B4768B3A93A45C0E6955C\")", "rel": "self", "method": "GET", "mediaType": "application/json" }, { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/AF6B75DBBCA244FC93166610EA2BA62A/categories?fields=id,name,parent,isSiteCategory&q=(parent.id eq \"F54C934D081B4768B3A93A45C0E6955C\")", "rel": "canonical", "method": "GET", "mediaType": "application/json" }, { "href": "http://<hostname>/content/management/api/v1.1/metadata-catalog/taxonomies/AF6B75DBBCA244FC93166610EA2BA62A/categories", "rel": "describedby", "method": "GET", "mediaType": "application/json" }, { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/AF6B75DBBCA244FC93166610EA2BA62A/categories?fields=id,name,parent,isSiteCategory&offset=0&q=(parent.id eq \"F54C934D081B4768B3A93A45C0E6955C\")", "rel": "first", "method": "GET", "mediaType": "application/json" }, { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/AF6B75DBBCA244FC93166610EA2BA62A/categories?fields=id,name,parent,isSiteCategory&offset=0&q=(parent.id eq \"F54C934D081B4768B3A93A45C0E6955C\")", "rel": "last", "method": "GET", "mediaType": "application/json" } ] }
Example 10:
This returns all the categories on the root level of this taxonomy (taxonomy ID is used as parent.id in the query).
/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?q=(status eq \"draft\") and (parent.id eq \"5AFA6CEA72354DC595A0EE751AE3A206\")
Response Body
{ "hasMore": false, "offset": 0, "count": 4, "limit": 4, "items": [ { "id": "2AD580D68D6C4874B76805EFF43DD62F", "name": "C1", "description": "C1 - description", "apiName": "exa-c1", "position": 0, "status": "draft", "parentId": "5AFA6CEA72354DC595A0EE751AE3A206", "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories/2AD580D68D6C4874B76805EFF43DD62F?q=(status eq \"draft\")", "rel": "self", "method": "GET", "mediaType": "application/json" } ] }, { "id": "566B4BE231CA463B96381F120DD4CB83", "name": "C2", "description": "C2 - description", "apiName": "exa-c2", "position": 1, "status": "draft", "parentId": "5AFA6CEA72354DC595A0EE751AE3A206", "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories/566B4BE231CA463B96381F120DD4CB83?q=(status eq \"draft\")", "rel": "self", "method": "GET", "mediaType": "application/json" } ] }, { "id": "71B006B6F8F244059DAC00EF5E0159F5", "name": "C3", "description": "C3 - description", "apiName": "exa-c3", "position": 2, "status": "draft", "parentId": "5AFA6CEA72354DC595A0EE751AE3A206", "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories/71B006B6F8F244059DAC00EF5E0159F5?q=(status eq \"draft\")", "rel": "self", "method": "GET", "mediaType": "application/json" } ] }, { "id": "4CD7E153F7474112A22B20DFFCA97ABE", "name": "C4", "description": "C4 - description", "apiName": "exa-c4", "position": 3, "status": "draft", "parentId": "5AFA6CEA72354DC595A0EE751AE3A206", "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories/4CD7E153F7474112A22B20DFFCA97ABE?q=(status eq \"draft\")", "rel": "self", "method": "GET", "mediaType": "application/json" } ] } ], "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?q=(status eq \"draft\") and (parent.id eq \"5AFA6CEA72354DC595A0EE751AE3A206\")", "rel": "self", "method": "GET", "mediaType": "application/json" }, { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?q=(status eq \"draft\") and (parent.id eq \"5AFA6CEA72354DC595A0EE751AE3A206\")", "rel": "canonical", "method": "GET", "mediaType": "application/json" }, { "href": "http://<hostname>/content/management/api/v1.1/metadata-catalog/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories", "rel": "describedby", "method": "GET", "mediaType": "application/schema+json" }, { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?offset=0&q=(status eq \"draft\") and (parent.id eq \"5AFA6CEA72354DC595A0EE751AE3A206\")", "rel": "first", "method": "GET", "mediaType": "application/json" }, { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?offset=0&q=(status eq \"draft\") and (parent.id eq \"5AFA6CEA72354DC595A0EE751AE3A206\")", "rel": "last", "method": "GET", "mediaType": "application/json" } ] }
Example 11:
This returns all the children categories of parent category C1 (ID = 2AD580D68D6C4874B76805EFF43DD62F).
/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?orderBy=name:asc&q=(status eq \"draft\") and (parent.id eq \"2AD580D68D6C4874B76805EFF43DD62F\")
Response Body
{ "hasMore": false, "offset": 0, "count": 4, "limit": 4, "items": [ { "id": "2AD580D68D6C4874B76805EFF43DD62F", "name": "C1", "description": "C1 - description", "apiName": "exa-c1", "position": 0, "status": "draft", "parentId": "5AFA6CEA72354DC595A0EE751AE3A206", "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories/2AD580D68D6C4874B76805EFF43DD62F?q=(status eq \"draft\")", "rel": "self", "method": "GET", "mediaType": "application/json" } ] }, { "id": "566B4BE231CA463B96381F120DD4CB83", "name": "C2", "description": "C2 - description", "apiName": "exa-c2", "position": 1, "status": "draft", "parentId": "5AFA6CEA72354DC595A0EE751AE3A206", "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories/566B4BE231CA463B96381F120DD4CB83?q=(status eq \"draft\")", "rel": "self", "method": "GET", "mediaType": "application/json" } ] }, { "id": "71B006B6F8F244059DAC00EF5E0159F5", "name": "C3", "description": "C3 - description", "apiName": "exa-c3", "position": 2, "status": "draft", "parentId": "5AFA6CEA72354DC595A0EE751AE3A206", "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories/71B006B6F8F244059DAC00EF5E0159F5?q=(status eq \"draft\")", "rel": "self", "method": "GET", "mediaType": "application/json" } ] }, { "id": "4CD7E153F7474112A22B20DFFCA97ABE", "name": "C4", "description": "C4 - description", "apiName": "exa-c4", "position": 3, "status": "draft", "parentId": "5AFA6CEA72354DC595A0EE751AE3A206", "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories/4CD7E153F7474112A22B20DFFCA97ABE?q=(status eq \"draft\")", "rel": "self", "method": "GET", "mediaType": "application/json" } ] } ], "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?q=(status eq \"draft\") and (parent.id eq \"5AFA6CEA72354DC595A0EE751AE3A206\")", "rel": "self", "method": "GET", "mediaType": "application/json" }, { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?q=(status eq \"draft\") and (parent.id eq \"5AFA6CEA72354DC595A0EE751AE3A206\")", "rel": "canonical", "method": "GET", "mediaType": "application/json" }, { "href": "http://<hostname>/content/management/api/v1.1/metadata-catalog/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories", "rel": "describedby", "method": "GET", "mediaType": "application/schema+json" }, { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?offset=0&q=(status eq \"draft\") and (parent.id eq \"5AFA6CEA72354DC595A0EE751AE3A206\")", "rel": "first", "method": "GET", "mediaType": "application/json" }, { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?offset=0&q=(status eq \"draft\") and (parent.id eq \"5AFA6CEA72354DC595A0EE751AE3A206\")", "rel": "last", "method": "GET", "mediaType": "application/json" } ] }
Example 12:
This returns all promoted categories whose name starts with 'C1'.
/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?orderBy=name:asc&q=(status eq \"promoted\") and (name sw \"C1\")
Response Body
{ "hasMore": false, "offset": 0, "count": 4, "limit": 4, "items": [ { "id": "2AD580D68D6C4874B76805EFF43DD62F", "name": "C1", "description": "C1 - description", "apiName": "exa-c1", "position": 0, "status": "promoted", "parentId": "5AFA6CEA72354DC595A0EE751AE3A206", "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories/2AD580D68D6C4874B76805EFF43DD62F?q=(status eq \"promoted\")", "rel": "self", "method": "GET", "mediaType": "application/json" } ] }, { "id": "E09FE769278748019F525B26C083EBA4", "name": "C1.1", "description": "C1.1 - description", "apiName": "exa-c11", "position": 0, "status": "promoted", "parentId": "2AD580D68D6C4874B76805EFF43DD62F", "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories/E09FE769278748019F525B26C083EBA4?q=(status eq \"promoted\")", "rel": "self", "method": "GET", "mediaType": "application/json" } ] }, { "id": "52720DCA057B42F3A39BA4E0507186DA", "name": "C1.2", "description": "C1.2 - description", "apiName": "exa-c12", "position": 1, "status": "promoted", "parentId": "2AD580D68D6C4874B76805EFF43DD62F", "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories/52720DCA057B42F3A39BA4E0507186DA?q=(status eq \"promoted\")", "rel": "self", "method": "GET", "mediaType": "application/json" } ] }, { "id": "2D3E74A2B3514EC7B0136B1633EEE919", "name": "C1.3", "description": "C1.3 - description", "apiName": "exa-c13", "position": 2, "status": "promoted", "parentId": "2AD580D68D6C4874B76805EFF43DD62F", "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories/2D3E74A2B3514EC7B0136B1633EEE919?q=(status eq \"promoted\")", "rel": "self", "method": "GET", "mediaType": "application/json" } ] } ], "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?orderBy=name:asc&q=(status eq \"promoted\") and (name sw \"C1\")", "rel": "self", "method": "GET", "mediaType": "application/json" }, { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?orderBy=name:asc&q=(status eq \"promoted\") and (name sw \"C1\")", "rel": "canonical", "method": "GET", "mediaType": "application/json" }, { "href": "http://<hostname>/content/management/api/v1.1/metadata-catalog/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories", "rel": "describedby", "method": "GET", "mediaType": "application/schema+json" }, { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?offset=0&orderBy=name:asc&q=(status eq \"promoted\") and (name sw \"C1\")", "rel": "first", "method": "GET", "mediaType": "application/json" }, { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?offset=0&orderBy=name:asc&q=(status eq \"promoted\") and (name sw \"C1\")", "rel": "last", "method": "GET", "mediaType": "application/json" } ] }
Example 13:
This returns the draft category with apiName 'exa-c4'.
/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?q=(status eq \"draft\") and (apiName eq \"exa-c4\")"
Response Body
{ "hasMore": false, "offset": 0, "count": 1, "limit": 1, "items": [ { "id": "4CD7E153F7474112A22B20DFFCA97ABE", "name": "C4", "description": "C4 - draft", "apiName": "exa-c4", "parentId": "5AFA6CEA72354DC595A0EE751AE3A206", "position": 3, "status": "draft", "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories/4CD7E153F7474112A22B20DFFCA97ABE", "rel": "self", "method": "GET", "mediaType": "application/json" } ] } ], "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?q=(status eq \"draft\") and (apiName eq \"C4-UNIQUE\")", "rel": "self", "method": "GET", "mediaType": "application/json" }, { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?q=(status eq \"draft\") and (apiName eq \"C4-UNIQUE\")", "rel": "canonical", "method": "GET", "mediaType": "application/json" }, { "href": "http://<hostname>/content/management/api/v1.1/metadata-catalog/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories", "rel": "describedby", "method": "GET", "mediaType": "application/schema+json" }, { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?offset=0&q=(status eq \"draft\") and (apiName eq \"C4-UNIQUE\")", "rel": "first", "method": "GET", "mediaType": "application/json" }, { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?offset=0&q=(status eq \"draft\") and (apiName eq \"C4-UNIQUE\")", "rel": "last", "method": "GET", "mediaType": "application/json" } ] }
Example 14:
This returns all promoted categories matching category ids.
/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?q=(status eq \"promoted\") and (id eq \"566B4BE231CA463B96381F120DD4CB83\" OR id eq \"71B006B6F8F244059DAC00EF5E0159F5\")
Response Body
{ "hasMore": false, "offset": 0, "count": 1, "limit": 1, "items": [ { "id": "566B4BE231CA463B96381F120DD4CB83", "name": "C2", "description": "C2 - description", "apiName": "exa-c2", "position": 1, "status": "promoted", "parentId": "5AFA6CEA72354DC595A0EE751AE3A206", "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories/566B4BE231CA463B96381F120DD4CB83?q=(status eq \"promoted\")", "rel": "self", "method": "GET", "mediaType": "application/json" } ] }, { "id": "71B006B6F8F244059DAC00EF5E0159F5", "name": "C3", "description": "C3 - description", "apiName": "exa-c3", "position": 2, "status": "promoted", "parentId": "5AFA6CEA72354DC595A0EE751AE3A206", "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories/71B006B6F8F244059DAC00EF5E0159F5?q=(status eq \"promoted\")", "rel": "self", "method": "GET", "mediaType": "application/json" } ] } ], "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?q=(status eq \"promoted\") and (id eq \"566B4BE231CA463B96381F120DD4CB83\")", "rel": "self", "method": "GET", "mediaType": "application/json" }, { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?q=(status eq \"promoted\") and (id eq \"566B4BE231CA463B96381F120DD4CB83\")", "rel": "canonical", "method": "GET", "mediaType": "application/json" }, { "href": "http://<hostname>/content/management/api/v1.1/metadata-catalog/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories", "rel": "describedby", "method": "GET", "mediaType": "application/schema+json" }, { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?offset=0&q=(status eq \"promoted\") and (id eq \"566B4BE231CA463B96381F120DD4CB83\")", "rel": "first", "method": "GET", "mediaType": "application/json" }, { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?offset=0&q=(status eq \"promoted\") and (id eq \"566B4BE231CA463B96381F120DD4CB83\")", "rel": "last", "method": "GET", "mediaType": "application/json" } ] }
Example 15:
This returns all draft categories at the root level of this taxonomy. It will offset categories in the result by 1.
/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?orderBy=name:asc&q=(status eq \"draft\") and (parent.id eq \"5AFA6CEA72354DC595A0EE751AE3A206\")&offset=1
Response Body
{ "hasMore": false, "offset": 1, "count": 3, "limit": 4, "items": [ { "id": "566B4BE231CA463B96381F120DD4CB83", "name": "C2", "description": "C2 - description", "apiName": "exa-c2", "position": 1, "status": "draft", "parentId": "5AFA6CEA72354DC595A0EE751AE3A206", "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories/566B4BE231CA463B96381F120DD4CB83?q=(status eq \"draft\")", "rel": "self", "method": "GET", "mediaType": "application/json" } ] }, { "id": "71B006B6F8F244059DAC00EF5E0159F5", "name": "C3", "description": "C3 - description", "apiName": "exa-c3", "position": 2, "status": "draft", "parentId": "5AFA6CEA72354DC595A0EE751AE3A206", "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories/71B006B6F8F244059DAC00EF5E0159F5?q=(status eq \"draft\")", "rel": "self", "method": "GET", "mediaType": "application/json" } ] }, { "id": "4CD7E153F7474112A22B20DFFCA97ABE", "name": "C4", "description": "C4 - description", "apiName": "exa-c4", "position": 3, "status": "draft", "parentId": "5AFA6CEA72354DC595A0EE751AE3A206", "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories/4CD7E153F7474112A22B20DFFCA97ABE?q=(status eq \"draft\")", "rel": "self", "method": "GET", "mediaType": "application/json" } ] } ], "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?orderBy=name:asc&q=(status eq \"draft\") and (parent.id eq \"5AFA6CEA72354DC595A0EE751AE3A206\")&offset=1", "rel": "self", "method": "GET", "mediaType": "application/json" }, { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?orderBy=name:asc&q=(status eq \"draft\") and (parent.id eq \"5AFA6CEA72354DC595A0EE751AE3A206\")&offset=1", "rel": "canonical", "method": "GET", "mediaType": "application/json" }, { "href": "http://<hostname>/content/management/api/v1.1/metadata-catalog/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories", "rel": "describedby", "method": "GET", "mediaType": "application/schema+json" }, { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?orderBy=name:asc&q=(status eq \"draft\") and (parent.id eq \"5AFA6CEA72354DC595A0EE751AE3A206\")&offset=0", "rel": "prev", "method": "GET", "mediaType": "application/json" }, { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?orderBy=name:asc&q=(status eq \"draft\") and (parent.id eq \"5AFA6CEA72354DC595A0EE751AE3A206\")&offset=0", "rel": "first", "method": "GET", "mediaType": "application/json" }, { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?orderBy=name:asc&q=(status eq \"draft\") and (parent.id eq \"5AFA6CEA72354DC595A0EE751AE3A206\")&offset=1", "rel": "last", "method": "GET", "mediaType": "application/json" } ] }
Example 16:
This returns two promoted categories at the root level of this taxonomy. It will offset categories in the result by 1 and it will fetch only two categories at a time.
/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?limit=2&orderBy=name:asc&q=(status eq \"promoted\") and (parent.id eq \"5AFA6CEA72354DC595A0EE751AE3A206\")&offset=1
Response Body
{ "hasMore": true, "offset": 1, "count": 2, "limit": 2, "items": [ { "id": "566B4BE231CA463B96381F120DD4CB83", "name": "C2", "description": "C2 - description", "apiName": "exa-c2", "position": 1, "status": "promoted", "parentId": "5AFA6CEA72354DC595A0EE751AE3A206", "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories/566B4BE231CA463B96381F120DD4CB83?q=(status eq \"promoted\")", "rel": "self", "method": "GET", "mediaType": "application/json" } ] }, { "id": "71B006B6F8F244059DAC00EF5E0159F5", "name": "C3", "description": "C3 - description", "apiName": "exa-c3", "position": 2, "status": "promoted", "parentId": "5AFA6CEA72354DC595A0EE751AE3A206", "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories/71B006B6F8F244059DAC00EF5E0159F5?q=(status eq \"promoted\")", "rel": "self", "method": "GET", "mediaType": "application/json" } ] } ], "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?limit=2&orderBy=name:asc&q=(status eq \"promoted\") and (parent.id eq \"5AFA6CEA72354DC595A0EE751AE3A206\")&offset=1", "rel": "self", "method": "GET", "mediaType": "application/json" }, { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?limit=2&orderBy=name:asc&q=(status eq \"promoted\") and (parent.id eq \"5AFA6CEA72354DC595A0EE751AE3A206\")&offset=1", "rel": "canonical", "method": "GET", "mediaType": "application/json" }, { "href": "http://<hostname>/content/management/api/v1.1/metadata-catalog/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories", "rel": "describedby", "method": "GET", "mediaType": "application/schema+json" }, { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?limit=2&orderBy=name:asc&q=(status eq \"promoted\") and (parent.id eq \"5AFA6CEA72354DC595A0EE751AE3A206\")&offset=0", "rel": "prev", "method": "GET", "mediaType": "application/json" }, { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?limit=2&orderBy=name:asc&q=(status eq \"promoted\") and (parent.id eq \"5AFA6CEA72354DC595A0EE751AE3A206\")&offset=3", "rel": "next", "method": "GET", "mediaType": "application/json" }, { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?limit=2&orderBy=name:asc&q=(status eq \"promoted\") and (parent.id eq \"5AFA6CEA72354DC595A0EE751AE3A206\")&offset=0", "rel": "first", "method": "GET", "mediaType": "application/json" }, { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?limit=2&orderBy=name:asc&q=(status eq \"promoted\") and (parent.id eq \"5AFA6CEA72354DC595A0EE751AE3A206\")&offset=3", "rel": "last", "method": "GET", "mediaType": "application/json" } ] }
Example 17:
It returns three promoted categories, which name starts with 'C'. It will fetch only 3 categories at a time, sorted by name ascending and it will display the total number of matching categories with this query.
/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?limit=3&orderBy=name:asc&q=(status eq \"promoted\") and (name sw \"C\")&totalResults=true
Response Body
{ "hasMore": true, "offset": 0, "count": 3, "limit": 3, "totalResults": 7, "items": [ { "id": "2AD580D68D6C4874B76805EFF43DD62F", "name": "C1", "description": "C1 - description", "apiName": "exa-c1", "position": 0, "status": "promoted", "parentId": "5AFA6CEA72354DC595A0EE751AE3A206", "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories/2AD580D68D6C4874B76805EFF43DD62F?q=(status eq \"promoted\")", "rel": "self", "method": "GET", "mediaType": "application/json" } ] }, { "id": "E09FE769278748019F525B26C083EBA4", "name": "C1.1", "description": "C1.1 - description", "apiName": "exa-c11", "position": 0, "status": "promoted", "parentId": "2AD580D68D6C4874B76805EFF43DD62F", "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories/E09FE769278748019F525B26C083EBA4?q=(status eq \"promoted\")", "rel": "self", "method": "GET", "mediaType": "application/json" } ] }, { "id": "52720DCA057B42F3A39BA4E0507186DA", "name": "C1.2", "description": "C1.2 - description", "apiName": "exa-c12", "position": 1, "status": "promoted", "parentId": "2AD580D68D6C4874B76805EFF43DD62F", "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories/52720DCA057B42F3A39BA4E0507186DA?q=(status eq \"promoted\")", "rel": "self", "method": "GET", "mediaType": "application/json" } ] } ], "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?limit=3&orderBy=name:asc&q=(status eq \"promoted\") and (name sw \"C\")&totalResults=true", "rel": "self", "method": "GET", "mediaType": "application/json" }, { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?limit=3&orderBy=name:asc&q=(status eq \"promoted\") and (name sw \"C\")&totalResults=true", "rel": "canonical", "method": "GET", "mediaType": "application/json" }, { "href": "http://<hostname>/content/management/api/v1.1/metadata-catalog/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories", "rel": "describedby", "method": "GET", "mediaType": "application/schema+json" }, { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?limit=3&orderBy=name:asc&q=(status eq \"promoted\") and (name sw \"C\")&totalResults=true&offset=3", "rel": "next", "method": "GET", "mediaType": "application/json" }, { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?limit=3&orderBy=name:asc&q=(status eq \"promoted\") and (name sw \"C\")&totalResults=true&offset=0", "rel": "first", "method": "GET", "mediaType": "application/json" }, { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?limit=3&orderBy=name:asc&q=(status eq \"promoted\") and (name sw \"C\")&totalResults=true&offset=6", "rel": "last", "method": "GET", "mediaType": "application/json" } ] }
Example 18:
It returns three promoted root categories sorted by position in descending order.
/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?limit=3&orderBy=position:desc&q=(status eq \"promoted\") and (parent.id eq \"5AFA6CEA72354DC595A0EE751AE3A206\")
Response Body
{ "hasMore": true, "offset": 0, "count": 3, "limit": 3, "items": [ { "id": "4CD7E153F7474112A22B20DFFCA97ABE", "name": "C4", "description": "C4 - description", "apiName": "exa-c4", "position": 3, "status": "promoted", "parentId": "5AFA6CEA72354DC595A0EE751AE3A206", "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories/4CD7E153F7474112A22B20DFFCA97ABE?q=(status eq \"promoted\")", "rel": "self", "method": "GET", "mediaType": "application/json" } ] }, { "id": "71B006B6F8F244059DAC00EF5E0159F5", "name": "C3", "description": "C3 - description", "apiName": "exa-c3", "position": 2, "status": "promoted", "parentId": "5AFA6CEA72354DC595A0EE751AE3A206", "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories/71B006B6F8F244059DAC00EF5E0159F5?q=(status eq \"promoted\")", "rel": "self", "method": "GET", "mediaType": "application/json" } ] }, { "id": "566B4BE231CA463B96381F120DD4CB83", "name": "C2", "description": "C2 - description", "apiName": "exa-c2", "position": 1, "status": "promoted", "parentId": "5AFA6CEA72354DC595A0EE751AE3A206", "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories/566B4BE231CA463B96381F120DD4CB83?q=(status eq \"promoted\")", "rel": "self", "method": "GET", "mediaType": "application/json" } ] } ], "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?limit=3&orderBy=position:desc&q=(status eq \"promoted\") and (parent.id eq \"5AFA6CEA72354DC595A0EE751AE3A206\")", "rel": "self", "method": "GET", "mediaType": "application/json" }, { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?limit=3&orderBy=position:desc&q=(status eq \"promoted\") and (parent.id eq \"5AFA6CEA72354DC595A0EE751AE3A206\")", "rel": "canonical", "method": "GET", "mediaType": "application/json" }, { "href": "http://<hostname>/content/management/api/v1.1/metadata-catalog/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories", "rel": "describedby", "method": "GET", "mediaType": "application/schema+json" }, { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?limit=3&orderBy=position:desc&q=(status eq \"promoted\") and (parent.id eq \"5AFA6CEA72354DC595A0EE751AE3A206\")&offset=3", "rel": "next", "method": "GET", "mediaType": "application/json" }, { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?limit=3&orderBy=position:desc&q=(status eq \"promoted\") and (parent.id eq \"5AFA6CEA72354DC595A0EE751AE3A206\")&offset=0", "rel": "first", "method": "GET", "mediaType": "application/json" }, { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?limit=3&orderBy=position:desc&q=(status eq \"promoted\") and (parent.id eq \"5AFA6CEA72354DC595A0EE751AE3A206\")&offset=3", "rel": "last", "method": "GET", "mediaType": "application/json" } ] }
Example 19:
It returns all draft root categories with their respective children count. It will also include a link to fully expand children for each category.
/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?fields=id,name,children&q=(status eq \"draft\") and (parent.id eq \"5AFA6CEA72354DC595A0EE751AE3A206\")
Response Body
{ "hasMore": false, "offset": 0, "count": 3, "limit": 3, "items": [ { "id": "2AD580D68D6C4874B76805EFF43DD62F", "name": "C1", "children": { "count": 3, "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories/2AD580D68D6C4874B76805EFF43DD62F?q=(status eq \"draft\")&expand=children", "rel": "child", "method": "GET", "mediaType": "application/json" } ] }, "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories/2AD580D68D6C4874B76805EFF43DD62F?q=(status eq \"draft\")", "rel": "self", "method": "GET", "mediaType": "application/json" } ] }, { "id": "566B4BE231CA463B96381F120DD4CB83", "name": "C2", "children": { "count": 0, "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories/566B4BE231CA463B96381F120DD4CB83?q=(status eq \"draft\")&expand=children", "rel": "child", "method": "GET", "mediaType": "application/json" } ] }, "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories/566B4BE231CA463B96381F120DD4CB83?q=(status eq \"draft\")", "rel": "self", "method": "GET", "mediaType": "application/json" } ] }, { "id": "71B006B6F8F244059DAC00EF5E0159F5", "name": "C3", "children": { "count": 0, "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories/71B006B6F8F244059DAC00EF5E0159F5?q=(status eq \"draft\")&expand=children", "rel": "child", "method": "GET", "mediaType": "application/json" } ] }, "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories/71B006B6F8F244059DAC00EF5E0159F5?q=(status eq \"draft\")", "rel": "self", "method": "GET", "mediaType": "application/json" } ] }, { "id": "4CD7E153F7474112A22B20DFFCA97ABE", "name": "C4", "children": { "count": 0, "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories/4CD7E153F7474112A22B20DFFCA97ABE?q=(status eq \"draft\")&expand=children", "rel": "child", "method": "GET", "mediaType": "application/json" } ] }, "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories/4CD7E153F7474112A22B20DFFCA97ABE?q=(status eq \"draft\")", "rel": "self", "method": "GET", "mediaType": "application/json" } ] } ], "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?limit=3&orderBy=position:desc&q=(status eq \"promoted\") and (parent.id eq \"5AFA6CEA72354DC595A0EE751AE3A206\")", "rel": "self", "method": "GET", "mediaType": "application/json" }, { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?limit=3&orderBy=position:desc&q=(status eq \"promoted\") and (parent.id eq \"5AFA6CEA72354DC595A0EE751AE3A206\")", "rel": "canonical", "method": "GET", "mediaType": "application/json" }, { "href": "http://<hostname>/content/management/api/v1.1/metadata-catalog/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories", "rel": "describedby", "method": "GET", "mediaType": "application/schema+json" }, { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?limit=3&orderBy=position:desc&q=(status eq \"promoted\") and (parent.id eq \"5AFA6CEA72354DC595A0EE751AE3A206\")&offset=3", "rel": "next", "method": "GET", "mediaType": "application/json" }, { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?limit=3&orderBy=position:desc&q=(status eq \"promoted\") and (parent.id eq \"5AFA6CEA72354DC595A0EE751AE3A206\")&offset=0", "rel": "first", "method": "GET", "mediaType": "application/json" }, { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/5AFA6CEA72354DC595A0EE751AE3A206/categories?limit=3&orderBy=position:desc&q=(status eq \"promoted\") and (parent.id eq \"5AFA6CEA72354DC595A0EE751AE3A206\")&offset=3", "rel": "last", "method": "GET", "mediaType": "application/json" } ] }
Example 20:
This returns all the categories with a specified set of fields under parent category F54C934D081B4768B3A93A45C0E6955C of taxonomy AF6B75DBBCA244FC93166610EA2BA62A.
/content/management/api/v1.1/taxonomies/AF6B75DBBCA244FC93166610EA2BA62A/categories?q=(parent.id eq \"F54C934D081B4768B3A93A45C0E6955C\")&fields=id,name,parent,isSiteCategory
Response Body
{ "hasMore": false, "offset": 0, "count": 2, "limit": 2, "items": [ { "id": "4136D8D1FD5C4241A3E08A42765D615C", "name": "Site1_site_category", "isSiteCategory": true, "parent": { "id": "F54C934D081B4768B3A93A45C0E6955C", "name": "team1", "apiName": "sst-o-d" }, "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/AF6B75DBBCA244FC93166610EA2BA62A/categories/4136D8D1FD5C4241A3E08A42765D615C", "rel": "self", "method": "GET", "mediaType": "application/json" } ] }, { "id": "3DDAED10146B434EA706F94380E13B07", "name": "subteam1", "isSiteCategory": false, "parent": { "id": "F54C934D081B4768B3A93A45C0E6955C", "name": "team1", "apiName": "sst-o-d" }, "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/AF6B75DBBCA244FC93166610EA2BA62A/categories/3DDAED10146B434EA706F94380E13B07", "rel": "self", "method": "GET", "mediaType": "application/json" } ] } ], "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/AF6B75DBBCA244FC93166610EA2BA62A/categories?fields=id,name,parent,isSiteCategory&q=(parent.id eq \"F54C934D081B4768B3A93A45C0E6955C\")", "rel": "self", "method": "GET", "mediaType": "application/json" }, { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/AF6B75DBBCA244FC93166610EA2BA62A/categories?fields=id,name,parent,isSiteCategory&q=(parent.id eq \"F54C934D081B4768B3A93A45C0E6955C\")", "rel": "canonical", "method": "GET", "mediaType": "application/json" }, { "href": "http://<hostname>/content/management/api/v1.1/metadata-catalog/taxonomies/AF6B75DBBCA244FC93166610EA2BA62A/categories", "rel": "describedby", "method": "GET", "mediaType": "application/json" }, { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/AF6B75DBBCA244FC93166610EA2BA62A/categories?fields=id,name,parent,isSiteCategory&offset=0&q=(parent.id eq \"F54C934D081B4768B3A93A45C0E6955C\")", "rel": "first", "method": "GET", "mediaType": "application/json" }, { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/AF6B75DBBCA244FC93166610EA2BA62A/categories?fields=id,name,parent,isSiteCategory&offset=0&q=(parent.id eq \"F54C934D081B4768B3A93A45C0E6955C\")", "rel": "last", "method": "GET", "mediaType": "application/json" } ] }
Example 21:
This returns all the categories with a specified set of fields under taxonomy permissions matching with \"manager\".
/content/management/api/v1.1/taxonomies/AF6B75DBBCA244FC93166610EA2BA62A/categories?q=(roleName eq \"manager\")&fields=id,name,parent,isSiteCategory,roleName
Response Body
{ "hasMore": false, "offset": 0, "count": 2, "limit": 2, "items": [ { "id": "4136D8D1FD5C4241A3E08A42765D615C", "name": "cat_role_manager_1", "isSiteCategory": true, "roleName": "manager", "parent": { "id": "F54C934D081B4768B3A93A45C0E6955C", "name": "team1", "apiName": "sst-o-d" }, "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/AF6B75DBBCA244FC93166610EA2BA62A/categories/4136D8D1FD5C4241A3E08A42765D615C", "rel": "self", "method": "GET", "mediaType": "application/json" } ] }, { "id": "3DDAED10146B434EA706F94380E13B07", "name": "cat_role_manager_2", "isSiteCategory": false, "roleName": "manager", "parent": { "id": "F54C934D081B4768B3A93A45C0E6955C", "name": "team1", "apiName": "sst-o-d" }, "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/AF6B75DBBCA244FC93166610EA2BA62A/categories/3DDAED10146B434EA706F94380E13B07", "rel": "self", "method": "GET", "mediaType": "application/json" } ] } ], "links": [ { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/AF6B75DBBCA244FC93166610EA2BA62A/categories?fields=id,name,parent,isSiteCategory,roleName&q=(roleName eq \"manager\")", "rel": "self", "method": "GET", "mediaType": "application/json" }, { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/AF6B75DBBCA244FC93166610EA2BA62A/categories?fields=id,name,parent,isSiteCategory,roleName&q=(roleName eq \"manager\")", "rel": "canonical", "method": "GET", "mediaType": "application/json" }, { "href": "http://<hostname>/content/management/api/v1.1/metadata-catalog/taxonomies/AF6B75DBBCA244FC93166610EA2BA62A/categories", "rel": "describedby", "method": "GET", "mediaType": "application/json" }, { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/AF6B75DBBCA244FC93166610EA2BA62A/categories?fields=id,name,parent,isSiteCategory,roleName&offset=0&q=(roleName eq \"manager\")", "rel": "first", "method": "GET", "mediaType": "application/json" }, { "href": "http://<hostname>/content/management/api/v1.1/taxonomies/AF6B75DBBCA244FC93166610EA2BA62A/categories?fields=id,name,parent,isSiteCategory,roleName&offset=0&q=(roleName eq \"manager\")", "rel": "last", "method": "GET", "mediaType": "application/json" } ] }