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

 

To share a presentation with a set of users.

Request URL: (POST)

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

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


Request parameters

To cancel p share a presentation in Zoho Show we need to submit a form data with the following fields as mentioned below:

Field	Description
shareto	[string] - One or more Email IDs of Zoho Show users to whom the presentation is to be shared. For adding multiple users, separate them by 'comma'.
allowtowrite	[boolean] - Give access permission for editing the presentation to shared users. If true, then the users are allowed "Read/Write" access
notify [optional]	[boolean] - Sends notifications to the owner of the changes made to the presentation by shared users, if set to 'true'.
sendmail [optional]	[boolean] - Sends customised email message to the shared users, if set to 'true'

Sample Form (POST Method)

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

<input type="hidden" name="shareto" value="[Email IDs]">

<input type="hidden" name="allowtowrite" value="[true/false]">

<input type="submit" value="sharepresentation" name="submit">

</form>

Response fields

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

Field	Description
presentationId	Unique ID associated with the uploaded presentation.
presentationName	Name of the presentation that is being uploaded.
sharedTo	One or more Email IDs of Zoho Show users to whom the presentation is to be shared. For adding multiple users, separate them by 'comma'.

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/sharepresentation/3000000002057">
<result>

      <presentationId>3000000002057</presentationId>
      <presentationName>newtest</presentationName>
      <sharedTo>abc@gmail.com, pqr@mail.com, aa@email.com</sharedTo>

</result>
</response>

Equivalent JSON response

{
    "response":
    {
        "uri": "/api/private/json/sharepresentation/3000000002057",
        "result":
        {
             "presentationId":"3000000002057",
             "presentationName":"newtest",
             "sharedTo":"abc@gmail.com, pqr@mail.com, aa@email.com"
        }
    }
}

Errors

Sharing a presentation method may return general & input errors.