Tag
Tag Service
Web services for retrieving tags associated with content, people, and places. Tags cannot be created independently but are created and assigned as part of the base object creation. See Discussion for an example of how tags are created.
Jump to
Get Tag
GET /tags/{tagID}Return the specified tag with the specified fields.
Path Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
| tagID | String | true | ID of the tag to be returned |
Query Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
| fields | String | false | Fields to be returned |
Return Status:
| HTTP Status Code | Description |
|---|---|
| 200 (OK) | Request was successful |
| 400 (Bad Request) | An input field is malformed |
| 403 (Forbidden) | You are not allowed to access the specified tag |
| 404 (Not Found) | The specified tag does not exist |
Get Tag Following In
GET /tags/{tagID}/followingInReturn the list of custom streams in which the requesting user is following this tag.
Path Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
| tagID | String | true | ID of the tag to check for following |
Query Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
| fields | String | false | Fields to be included in the returned representation |
Retrieves:
Return Status:
| HTTP Status Code | Description |
|---|---|
| 200 (OK) | Request was successful |
| 400 (Bad Request) | An input field is malformed |
| 403 (Forbidden) | You are not allowed to access this place |
| 404 (Not Found) | The specified place does not exist |