The 'Add Slide' API, as the name suggests, allows you to insert a slide to a particular presentation.
Request URI:
Developers can send the request in the following URI format:
https://show.zoho.com/api/<access>/<format>/[presentation_id]/addslide?apikey=[API Key]&authtoken=[AuthToken]&scope=DataAPI
Access : private
Format : xml, json
HTTPs Method : POST
Form Request Parameters Reference
The following are the parameters that needs to be passed in multi-part HTTPs POST request for adding a new slide to a presentation in Show:
Parameter | Value
| Description |
position
| integer
| Optional. Select the position of the slide where it is to be added in the presentations.
Possible values: 1 to n numbers. [where the variable '1 to n' represents the slide number]
Note: if the position is greater than the no of slides, slide will be added at the end position.
|
layout-type
| string
| Optional. The type of slide layout chosen for the new slide.
Possible values:
TITLE|OBJ|SEC_HEADER|TWO_OBJ|TWO_OBJ_TWO_TXT|TITLE_ONLY|BLANK|OBJ_TXT|PIC_TXT
|
The image below shows different slide layout options.
Multi-part Form Submit - Sample
<form method="POST" action="https://show.zoho.com/api/private/xml/[presentation_id]/addslide" enctype="multipart/form-data"
target="_self" accept-charset="UTF-8">
<input type="hidden" name="apikey" value="[Zoho_API_Key]">
<input type="hidden" name ="authtoken" id="authtoken" value="bad18eba1ff45jk7858b8ae88a77fa30">
<input type="hidden" name ="scope" id="scope" value="DataAPI">
<input type="hidden" name="position" value="4">
<input type="hidden" name="layout-type" value="PIC_TXT">
<input type="submit" name="submit" value="Add Slide">
</form>
Response Parameters Reference
Parameter | Value
| Description |
presentationId
| integer
| Unique ID associated with a particular presentation.
|
slideId
| integer | Unique ID of a new slide added to the presentation.
|
Sample Response :
The following is a response (both in XML & JSON) for adding a new slide to a particular presentation.
XML
<?xml version="1.0" encoding="UTF-8" ?>
<response uri="/api/private/xml/15265000000006107/addslide">
<result>
<presentation>
<presentationId>15265000000006107</presentationId>
<slideId>50988770088338221</slideId>
</presentation>
</result>
</response>
JSON
{
"response":
{
"uri": "/api/private/json/15265000000006107/addslide",
"result":
{
"presentation":
{
"presentationId":"15265000000006107",
"slideId":"50988770088338221",
}
}
}
}