API Home >> Sheet >> API Reference >> tags

Remove a set of tags associated with a workbook.

 
Request URL : POST

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

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

Request parameters

To remove a set of tags associated to a workbook in Zoho Sheet we need to submit a form data to Zoho Sheet with the following field:

Field	Description
tags	[string] - One or more tag(s) to be removed with this workbook. For removing multiple tags, separate them by 'space'.

Sample Form (POST Method)

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

<input type="hidden" value="tags" value="tag1 tag2 tag3">

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

</form>

Response fields

Field	Description
workbookId	Unique ID associated with the workbook.
tag	Name of one or more tag(s) that is being removed from the workbook.

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/15265000000006067">
  <result>

     <workbookId>15265000000006067</workbookId>
        <tags>
        <tag name="color" /> 
             <tag name="reflection" />
     </tags>

  </result>
</response>

Equivalent JSON response

{
  "response":
   {
        "uri": "/api/private/json/removeTags/15265000000006067",
        "result":
        {
           "workbookId":"15265000000006067",
           "tags":
            {
                "tag":
                [
                     {
                        "name":"color"
                     },
                     {
                        "name":"reflection"
                     }
                ]
            }
         }
    }
}  

Errors

Renaming a workbook method may return general & input errors. Other specific HTTP error codes include 2851,2852 & 2853.