Platform API

<back to all web services

LinkTagForObject

Link existing tag to an object. Returns the list of tags assigned to the object.

Requires Authentication
The following routes are available for this service:
POST/api/tags/link/{ObjectId}
LinkTagForObject Parameters:
NameParameterData TypeRequiredDescription
ObjectIdqueryGuidNoObject Id to link the tag to.
LicenseeIdqueryGuidNoLicensee Id owner of the object.
IdqueryGuidNoId of the tag
ColourquerystringNoAssociated tag colour, if this is passed we will update the existing tags colour.
GetTagsListResponse Parameters:
NameParameterData TypeRequiredDescription
TagsqueryList<TagModel>NoList of tags.
ResponseStatusformResponseStatusNo
TagModel Parameters:
NameParameterData TypeRequiredDescription
IdqueryGuidNoId of the tag
NamequerystringNoTag name
RmsTableCtxIdqueryGuidNoRmsTableCtx Id that represents the type of object the tag an be linked to
ContactOwnerIdqueryGuidNoOwner Id to use to retrieve tags for a particular licensee
ColourquerystringNoAssociated tag colour
ObjectConnectionIdqueryGuidNoObject Connection Id linking an object to the tag

To override the Content-type in your clients, use the HTTP Accept Header, append the .json suffix or ?format=json

To embed the response in a jsonp callback, append ?callback=myCallback

HTTP + JSON

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /api/tags/link/{ObjectId} HTTP/1.1 
Host: pfapi.pstpf.com.au 
Accept: application/json
Content-Type: application/json
Content-Length: length

{"ObjectId":"00000000-0000-0000-0000-000000000000","LicenseeId":"00000000-0000-0000-0000-000000000000","Id":"00000000-0000-0000-0000-000000000000","Colour":"String"}
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length

{"Tags":[{"Id":"00000000-0000-0000-0000-000000000000","Name":"String","RmsTableCtxId":"00000000-0000-0000-0000-000000000000","ContactOwnerId":"00000000-0000-0000-0000-000000000000","Colour":"String","ObjectConnectionId":"00000000-0000-0000-0000-000000000000"}],"ResponseStatus":{"ErrorCode":"String","Message":"String","StackTrace":"String","Errors":[{"ErrorCode":"String","FieldName":"String","Message":"String","Meta":{"String":"String"}}],"Meta":{"String":"String"}}}