List Tags of an Item
get
/content/management/api/v1.1/items/{id}/tags
Lists all tags of a given item.
Request
Path Parameters
-
id: string
id of the item.
Query Parameters
-
links(optional): string
This parameter accepts a comma-separated list of link names. By default, this parameter gives all the links applicable. Possible values are: self, canonical, describedby
Response
Supported Media Types
- application/json
200 Response
OK.
Nested Schema : Tag
Type:
object
Tag.
Show Source
-
language:
string
language of the tag.
-
links(optional):
array links
Links
-
name:
string
Name of the tag.
Nested Schema : 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.
304 Response
Not modified.
400 Response
Bad request.
403 Response
Forbidden.
404 Response
Not found.
500 Response
Internal server error.
Examples
The following example shows how to list the tags of an item based on its ID by submitting a GET request using cURL.
curl -X GET -H 'Accept: application/json' 'https://host:port/content/management/api/v1.1/items/{id}/tags'
Example:
This provides a list of all tags of the item ID: CONT70DDEB1E83E54B6BB7BEBED43CEBC692.
/content/management/api/v1.1/items/CONT70DDEB1E83E54B6BB7BEBED43CEBC692/tags
Response Body
{ "data": [ { "name": "car" }, { "name": "vehicle" } ], "links": [ { "href": "https://<hostname>/content/management/api/v1.1/items/CORE70DDEB1E83E54B6BB7BEBED43CEBC692/tags", "rel": "self", "method": "GET", "mediaType": "application/json" } ] }