List taxonomy category properties
get
/content/management/api/v1.1/taxonomies/{id}/categoryProperties
List category properties definition of the taxonomy. You can control the number of properties to be fetched, paginated, and sorted. Category properties can be applied to categories in the taxonomy. All taxonomies have three system managed properties created automatically:Keywords: allow user to add a list of keywords or phrases to describe assets in the category Synonyms: allow user to add a list of synonyms, acronyms or aliases for the category name Related to: allow user to create a list of categories in the same or other taxonomies that are related to the category
Request
Path Parameters
-
id: string
id of the taxonomy.
Query Parameters
-
limit(optional): integer(int32)
This parameter accepts a non negative integer and is used to control the size of the result.Default Value:
20
-
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 follows the format of fieldName:[asc/desc]. asc stands for ascending order and desc stands for descending order.
Allowed fields are apiName and displayName. The default sort order is asc.Default Value:displayName:asc
-
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
Supported Media Types
- application/json
200 Response
OK.
Root Schema : CategoryPropertiesDefinition
Type:
object
CategoryPropertiesDefinition
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 CategoryPropertyDefinition
Category Property Definition
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 : CategoryPropertyDefinition
Type:
object
Category Property Definition
Show Source
-
apiName(optional):
string
Read Only:
true
Minimum Length:1
Maximum Length:64
API Name of the property. -
createdBy(optional):
string
Read Only:
true
The user who created the property. -
createdDate(optional):
object date
date
-
defaultValues(optional):
array defaultValues
Default values for the property.
-
description(optional):
string
Minimum Length:
0
Maximum Length:128
Description of the property. -
displayName:
string
Minimum Length:
1
Maximum Length:128
Display name of the property. -
id(optional):
string
Read Only:
true
id of the property. It is required in the GET response and PATCH request whereas it will be ignored in the POST request. -
isPublishable(optional):
boolean
Is the property publishable.
-
isSystemManaged(optional):
boolean
Read Only:
true
Is the property managed by the system. -
links(optional):
array links
Links
-
settings:
object PropertySettingsBean
-
updatedBy(optional):
string
Read Only:
true
The user who last updated the property. -
updatedDate(optional):
object date
date
-
valueCount:
string
Allowed Values:
[ "single", "list" ]
Value count as a single or list.
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 : PropertySettingsCaasBean
Type:
Show Source
object
-
customValidators(optional):
array customValidators
Custom validators for the property value.
-
editor(optional):
object PropertySettingsEditorBean
-
valueCountRange(optional):
object PropertySettingsValueCountRangeBean
Nested Schema : PropertySettingsEditorBean
Type:
Show Source
object
-
name(optional):
string
Name of the editor.
-
options(optional):
object options
Additional Properties Allowed: additionalPropertiesOptions of the property value.
Nested Schema : PropertySettingsValueCountRangeBean
Type:
Show Source
object
-
max(optional):
integer(int32)
Minimum Value:
1
Maximum count of the property value. -
min(optional):
integer(int32)
Minimum Value:
0
Minimum count of the property value.
Nested Schema : PropertySettingsValidatorBean
Type:
Show Source
object
-
options(optional):
object options
Additional Properties Allowed: additionalPropertiesValidator details.
-
type(optional):
string
Allowed Values:
[ "length" ]
Type of the validator.
Nested Schema : additionalProperties
Type:
object
Nested Schema : options
Type:
object
Additional Properties Allowed
Show Source
Options of the property value.
Nested Schema : additionalProperties
Type:
object
400 Response
Bad request.
404 Response
Taxonomy not found. The requested resource not found.
500 Response
Internal server error.