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}
import java.math.*
import java.util.*
import java.io.InputStream
import net.servicestack.client.*


/**
* Link existing tag to an object. Returns the list of tags assigned to the object.
*/
@Api(Description="Link existing tag to an object. Returns the list of tags assigned to the object.")
open class LinkTagForObject
{
    /**
    * Object Id to link the tag to.
    */
    @ApiMember(Description="Object Id to link the tag to.", ParameterType="query")
    open var ObjectId:UUID? = null

    /**
    * Licensee Id owner of the object.
    */
    @ApiMember(Description="Licensee Id owner of the object.", ParameterType="query")
    open var LicenseeId:UUID? = null

    /**
    * Id of the tag
    */
    @ApiMember(Description="Id of the tag", ParameterType="query")
    open var Id:UUID? = null

    /**
    * Associated tag colour, if this is passed we will update the existing tags colour.
    */
    @ApiMember(Description="Associated tag colour, if this is passed we will update the existing tags colour.", ParameterType="query")
    open var Colour:String? = null
}

@ApiResponse(Description="A list of tags")
open class GetTagsListResponse
{
    /**
    * List of tags.
    */
    @ApiMember(Description="List of tags.", ParameterType="query")
    open var Tags:ArrayList<TagModel>? = null

    open var ResponseStatus:ResponseStatus? = null
}

open class TagModel
{
    /**
    * Id of the tag
    */
    @ApiMember(Description="Id of the tag", ParameterType="query")
    open var Id:UUID? = null

    /**
    * Tag name
    */
    @ApiMember(Description="Tag name", ParameterType="query")
    open var Name:String? = null

    /**
    * RmsTableCtx Id that represents the type of object the tag an be linked to
    */
    @ApiMember(Description="RmsTableCtx Id that represents the type of object the tag an be linked to", ParameterType="query")
    open var RmsTableCtxId:UUID? = null

    /**
    * Owner Id to use to retrieve tags for a particular licensee
    */
    @ApiMember(Description="Owner Id to use to retrieve tags for a particular licensee", ParameterType="query")
    open var ContactOwnerId:UUID? = null

    /**
    * Associated tag colour
    */
    @ApiMember(Description="Associated tag colour", ParameterType="query")
    open var Colour:String? = null

    /**
    * Object Connection Id linking an object to the tag
    */
    @ApiMember(Description="Object Connection Id linking an object to the tag", ParameterType="query")
    open var ObjectConnectionId:UUID? = null
}

Kotlin LinkTagForObject DTOs

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

HTTP + OTHER

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: text/jsonl
Content-Type: text/jsonl
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: text/jsonl
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"}}}