API Home >> Show >> API Reference >> Private

Remove set of tags from a particular presentation.

Request URL :  POST Method

                             XML :  http://show.zoho.com/api/private/xml/removeTags/[presentationID]?apikey=[API Key]&ticket=[Ticket]

                            JSON : http://show.zoho.com/api/private/json/removeTags/[presentationID]?apikey=[API Key]&ticket=[Ticket]

Request parameters :

To remove a set of tags from a particular presentation we need to submit a form data to Show with the following fields:

Field	Description
presentationId	Unique ID of the presentation from which tags are to be removed.
tags	[string] - One or more tag(s) to be removed from this presentation. For removing multiple tags, separate them by 'space'.

Sample Form (POST Method)

<form method="POST"    action="http://show.zoho.com/api/private/xml/removeTags/[presentationId]?apikey=[APIKEY]&ticket=[Ticket]">

<input type="hidden" name="tagname" value="tag1 tag2 tag3">

<input type="submit" value="RemoveTags" class="divbutton" name="submit">

</form>

* It is mandatory to pass the apikey and ticket parameters to access the removeTags api.


Response fields

The schema presentation for the API response is located at: http://show.zoho.com/schema/api/addtags.xsd

Field	Description
presentationId	Unique ID associated with the presentation.
tag	Name of one or more tag(s) that is being removed from the presentation.
tag name	List of tag names to be removed

Sample Response

The following is the sample XML response for the above method:

<?xml version="1.0" encoding="UTF-8" ?>
<response uri="/api/private/xml/removeTags/8892000000064009">
  <result>

     <presentationId>8892000000064009</presentationId>
        <tag>
        <tag name="search" /> 
             <tag name="forecast" />
     </tag>

  </result>
</response>

Equivalent JSON response

{
  "response":
   {
        "uri": "/api/private/json/removeTags/8892000000064009",
        "result":
        {
           "presentationId":"8892000000064009",
           "tags":
            {
                "tag":
                [
                     {
                        "name":"search"
                     },
                     {
                        "name":"forecast"
                     }
                ]
            }
         }
    }
}  

Errors

Removing a set of tags from a presentation method may return general errors. Other HTTP error code may be 3404.