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.

Get Tag

GET /tags/{tagID}

Return the specified tag with the specified fields.

Path Parameters:
NameTypeRequiredDescription
tagIDStringtrueID of the tag to be returned
Query Parameters:
NameTypeRequiredDescription
fieldsStringfalseFields to be returned
Return Status:
HTTP Status CodeDescription
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}/followingIn

Return the list of custom streams in which the requesting user is following this tag.

Path Parameters:
NameTypeRequiredDescription
tagIDStringtrueID of the tag to check for following
Query Parameters:
NameTypeRequiredDescription
fieldsStringfalseFields to be included in the returned representation
Retrieves:
  • Stream[] in which the requesting user is following this place
  • Return Status:
    HTTP Status CodeDescription
    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