Slides API
Manage slides in a presentation. Supports inserting, listing, updating, reordering, duplicating, and deleting slides.
GET List Slides
GET https://show.zoho.com/api/v1/presentation/{rid}/slides
Required Scopes:
ZohoShow.showdocslist.READ
Lists slides in a presentation. Use this endpoint to build slide navigators, resolve slide ids, or fetch a small page of slide metadata before making slide-level updates. Pass ids to retrieve specific slides, or omit it to page through the deck with from and count. Returned slide objects include identifiers and available SDK slide fields, so they can be used directly with update, delete, duplicate, and element endpoints.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
| rid | string | Required | Resource id of the presentation. The caller must have the appropriate permission on this presentation. |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
| ids | string | Optional | Comma-separated slide ids to fetch. Omit this parameter to list all slides in the selected presentation. |
| from | integer | Optional | Zero-based offset for pagination. |
| count | integer | Optional | Maximum number of records to return. Allowed range: 1-99. |
Samples
Responses
200
Slides Retrieved
400
Invalid Count
400
Invalid Ids
400
Invalid From
{
"data": {
"slides": [
{
"slide_id": "54ca442b-63d1-43df-bda9-9f8cd2654e70",
"content": {}
},
{
"slide_id": "f64c0004-94f9-47a6-86b7-4c0187e96260",
"content": {}
},
{
"slide_id": "a106b398-409b-4add-a04b-6044c897f674",
"content": {
"orientation": "LANDSCAPE"
}
},
{
"slide_id": "16a4498f-c37f-4ba0-af74-07935a76996c",
"content": {
"graphic_objects": [
{
"shape": {
"text": {
"paragraphs": [
{
"portions": [
{
"style": {}
}
]
}
],
"properties": {}
},
"properties": {}
},
"id": "28859497-f5bf-4c60-bc85-853d79c5d06f"
},
{
"shape": {
"text": {
"paragraphs": [
{
"portions": [
{
"style": {}
}
]
}
],
"properties": {}
},
"properties": {}
},
"id": "bbc20ed0-3d64-44fa-8d7d-7e7a4d8cf82c"
}
]
}
},
{
"slide_id": "36a463ae-dbe9-46a6-830d-1b2824a8f4ac",
"content": {}
},
{
"slide_id": "80993f78-0719-47e3-b444-dbcfeb9d4632",
"content": {}
},
{
"slide_id": "8354a78a-1de9-4fce-8814-53e92f0d479d",
"content": {
"orientation": "LANDSCAPE"
}
},
{
"slide_id": "358c549d-7085-4f33-af43-bb3fdb87c53e",
"content": {}
},
{
"slide_id": "8452fe14-c181-4049-8780-7ebcf3422ca5",
"content": {}
},
{
"slide_id": "6ba37e43-fbd8-4921-85b3-36a1ea22e853",
"content": {
"graphic_objects": [
{
"shape": {
"text": {
"paragraphs": [
{
"id": "9529ce28-bfb4-5cc5-99c7-d4e613bcf45b",
"portions": [
{
"style": {
"fontweight": "NORMAL"
},
"text": "Title here"
}
]
}
],
"properties": {
"auto_fit": "TEXT"
}
},
"properties": {}
},
"id": "1dc85ffb-e2e4-4b27-adf4-f6a39d0c94de"
},
{
"shape": {
"text": {
"paragraphs": [
{
"portions": [
{
"style": {}
}
]
}
],
"properties": {}
},
"properties": {}
},
"id": "dd3f1125-4285-4d85-ab2f-20e4ea0bd095"
}
]
}
},
{
"slide_id": "134be983-951d-414d-ae01-62b1510e94c5",
"content": {
"graphic_objects": [
{
"shape": {
"text": {
"paragraphs": [
{
"id": "7340b6ad-9e42-52f9-9453-7b6e45c7b3ad",
"portions": [
{
"style": {
"fontweight": "NORMAL"
},
"text": "Title"
}
]
}
],
"properties": {
"auto_fit": "TEXT"
}
},
"properties": {}
},
"id": "dcbb2ae7-f06d-426a-9aab-148ab8451e97"
},
{
"shape": {
"text": {
"paragraphs": [
{
"id": "d936a7b1-d53b-51be-b8b1-4b1613472065",
"portions": [
{
"style": {
"fontweight": "NORMAL"
},
"text": "Subtitle"
}
]
}
],
"properties": {
"auto_fit": "TEXT"
}
},
"properties": {}
},
"id": "ae9bfcf4-c843-4edb-9ddc-c44871fe9096"
}
]
}
},
{
"slide_id": "aa914d4e-1bf1-4fea-ba7c-2188d1e2e2d2",
"content": {
"graphic_objects": [
{
"shape": {
"text": {
"paragraphs": [
{
"id": "3c5287e9-594c-5c1a-b965-2f46dd53d4dd",
"portions": [
{
"style": {
"fontweight": "NORMAL"
},
"text": "Title"
}
]
}
],
"properties": {
"auto_fit": "TEXT"
}
},
"properties": {}
},
"id": "c6eea0ff-1f65-4ac0-b8f4-1bc470cce3fa"
},
{
"shape": {
"text": {
"paragraphs": [
{
"portions": [
{
"style": {}
}
]
}
],
"properties": {}
},
"properties": {}
},
"id": "f6a2959b-96b2-4fb5-9f9d-40e5071672a8"
}
]
}
},
{
"slide_id": "daf8d60e-324a-40bf-a516-145022bea7bf",
"content": {
"graphic_objects": [
{
"shape": {
"text": {
"paragraphs": [
{
"id": "6d01612f-93b5-5951-9b14-d24848835d09",
"portions": [
{
"style": {
"fontweight": "NORMAL"
},
"text": "Title"
}
]
}
],
"properties": {
"auto_fit": "TEXT"
}
},
"properties": {}
},
"id": "fb9940d8-e30f-4f3e-a655-3ee1be73f180"
},
{
"shape": {
"text": {
"paragraphs": [
{
"portions": [
{
"style": {}
}
]
}
],
"properties": {}
},
"properties": {}
},
"id": "f59d5e28-6da8-48b1-9fbb-209e039a8865"
}
]
}
},
{
"slide_id": "7c768826-b4fb-4266-a5e0-31736c8d6eba",
"content": {}
},
{
"slide_id": "6450546a-cb81-4d9b-9974-6bc60f3714be",
"content": {
"orientation": "LANDSCAPE",
"graphic_objects": [
{
"shape": {
"text": {
"paragraphs": [
{
"id": "a77242c1-56d5-410e-892b-e1d1c9bf452b",
"portions": [
{
"style": {
"fontweight": "NORMAL"
}
}
]
}
],
"properties": {
"inset": {
"top": 5,
"left": 10,
"bottom": 5,
"right": 10
}
}
},
"basic": {
"type": "OVAL"
},
"properties": {
"layout": {
"top": 10,
"left": 10,
"width": 120,
"height": 120
},
"fills": [
{
"solid": {
"color": {
"rgb": {
"red": 255,
"green": 128
}
}
}
}
]
}
},
"id": "a0000000-0000-4000-8000-0000000000b1"
},
{
"connector": {
"connected": {
"first": {
"side": "EAST",
"shape_id": "a0000000-0000-4000-8000-0000000000b1"
},
"second": {
"side": "WEST",
"shape_id": "a0000000-0000-4000-8000-0000000000b1"
}
},
"type": "LINE",
"stroke": {
"width": 1,
"fill": {
"solid": {
"color": {
"rgb": {}
}
}
}
}
},
"id": "b0000000-0000-4000-8000-0000000000b2"
},
{
"id": "c0000000-0000-4000-8000-0000000000b3",
"picture": {
"media": {
"local_id": "c0000000-0000-4000-8000-0000000000b3"
},
"properties": {
"layout": {
"width": 100,
"height": 100
}
}
}
},
{
"id": "d0000000-0000-4000-8000-0000000000b4",
"table": {
"layout": {
"width": 100,
"height": 30
},
"columns": [
{
"width": 100
}
],
"style": {
"first_col": true,
"band_col": true,
"first_row": true
},
"style_ref": {
"local_id": "1"
},
"rows": [
{
"cells": [
{
"border": {
"top": {},
"left": {},
"bottom": {},
"right": {}
},
"text": {
"paragraphs": [
{
"style": {
"spacing": {
"line": 1.2
},
"level": 1
},
"id": "cc93e23b-def3-48e9-996b-71de5c7e917f",
"portions": [
{
"style": {
"size": 14,
"color": {
"rgb": {
"red": 255,
"green": 255,
"blue": 255
}
},
"font_name": {
"name": "Open Sans"
}
}
}
]
}
],
"properties": {
"inset": {
"top": 5,
"left": 10,
"bottom": 5,
"right": 10
}
}
}
}
],
"height": 30
}
]
}
},
{
"group_shape": {
"layout": {
"width": 200,
"height": 200
}
},
"id": "e0000000-0000-4000-8000-0000000000b5"
}
]
}
},
{
"slide_id": "cb87498d-92fa-4cc2-8252-b9bb9b2deff4",
"content": {
"graphic_objects": [
{
"shape": {
"text": {
"paragraphs": [
{
"id": "5bfc7fbb-3b71-5344-bb96-c3369763c834",
"portions": [
{
"style": {
"fontweight": "NORMAL"
},
"text": "Title placeholder"
}
]
}
],
"properties": {
"auto_fit": "TEXT"
}
},
"properties": {}
},
"id": "f17cdec3-b0f9-435d-b04d-ead948c4cf8f"
},
{
"shape": {
"text": {
"paragraphs": [
{
"portions": [
{
"style": {}
}
]
}
],
"properties": {}
},
"properties": {}
},
"id": "6fc2a46b-dc91-4453-b9db-d32699bbdefa"
}
]
}
},
{
"slide_id": "450b8d6b-2921-45c3-89b6-06da565da8b6",
"content": {}
},
{
"slide_id": "b13fc16b-0cc8-4162-82cd-792cf8bf56d3",
"content": {
"graphic_objects": [
{
"shape": {
"text": {
"paragraphs": [
{
"id": "db2480de-4224-5427-809c-213ec2a275c2",
"portions": [
{
"style": {
"fontweight": "NORMAL"
},
"text": "Title placeholder"
}
]
}
],
"properties": {
"auto_fit": "TEXT"
}
},
"properties": {}
},
"id": "862937c8-d6e4-42a9-a5f4-e7c899120aaf"
},
{
"shape": {
"text": {
"paragraphs": [
{
"id": "4b4204e2-6733-56e7-ac03-b3f28cd54b47",
"portions": [
{
"style": {
"fontweight": "NORMAL"
},
"text": "Subtitle placeholder"
}
]
}
],
"properties": {
"auto_fit": "TEXT"
}
},
"properties": {}
},
"id": "b95a1e4c-4938-4267-9ea2-b75a1d47a8bb"
}
]
}
},
{
"slide_id": "473d7440-37a7-4bdd-b951-7d4817ed9972",
"content": {
"graphic_objects": [
{
"shape": {
"text": {
"paragraphs": [
{
"id": "bc4c26bc-e8ef-5d5b-9c45-9c9d8620b440",
"portions": [
{
"style": {
"fontweight": "NORMAL"
},
"text": "Title placeholder"
}
]
}
],
"properties": {
"auto_fit": "TEXT"
}
},
"properties": {}
},
"id": "6a6d1e41-0125-4c5f-b2af-075ff72985a3"
},
{
"shape": {
"text": {
"paragraphs": [
{
"id": "55c9c5ad-3bdf-5646-93de-71cddaf372de",
"portions": [
{
"style": {
"fontweight": "NORMAL"
},
"text": "Subtitle placeholder"
}
]
}
],
"properties": {
"auto_fit": "TEXT"
}
},
"properties": {}
},
"id": "6f713c43-5799-4936-ade1-415c21a6c36b"
}
]
}
},
{
"slide_id": "4d2ff5e0-96ea-465a-b317-cccd20717137",
"content": {
"graphic_objects": [
{
"shape": {
"text": {
"paragraphs": [
{
"id": "ff849030-1f36-578f-9332-aafac553e4ab",
"portions": [
{
"style": {
"fontweight": "NORMAL"
},
"text": "Title placeholder"
}
]
}
],
"properties": {
"auto_fit": "TEXT"
}
},
"properties": {}
},
"id": "40fee0fc-4d00-4861-9259-4a117dc0ebf6"
},
{
"shape": {
"text": {
"paragraphs": [
{
"portions": [
{
"style": {}
}
]
}
],
"properties": {}
},
"properties": {}
},
"id": "3918161a-476f-4213-8682-d1054de4f4bd"
}
]
}
},
{
"slide_id": "f8b9c707-3a08-41bf-87fd-6848813e4eec",
"content": {
"graphic_objects": [
{
"shape": {
"text": {
"paragraphs": [
{
"id": "62b5425f-f66d-5137-939e-d2b0ea8d9ac5",
"portions": [
{
"style": {
"fontweight": "NORMAL"
},
"text": "Title placeholder"
}
]
}
],
"properties": {
"auto_fit": "TEXT"
}
},
"properties": {}
},
"id": "48f83eae-556d-4590-a176-6341e122d761"
},
{
"shape": {
"text": {
"paragraphs": [
{
"portions": [
{
"style": {}
}
]
}
],
"properties": {}
},
"properties": {}
},
"id": "a4f2493e-b898-4523-a505-3ff183523901"
}
]
}
},
{
"slide_id": "1c8a21b7-b636-409a-b823-3e54482c0bff",
"content": {
"graphic_objects": [
{
"shape": {
"text": {
"paragraphs": [
{
"id": "5217c857-6590-5d50-8935-c0fe0141f41a",
"portions": [
{
"style": {
"fontweight": "NORMAL"
},
"text": "Title placeholder"
}
]
}
],
"properties": {
"auto_fit": "TEXT"
}
},
"properties": {}
},
"id": "15963322-4fd0-46e8-9a51-f5dab99dcca1"
},
{
"shape": {
"text": {
"paragraphs": [
{
"portions": [
{
"style": {}
}
]
}
],
"properties": {}
},
"properties": {}
},
"id": "3d3ef597-f38b-4e52-acfa-643ff9e2fff4"
}
]
}
},
{
"slide_id": "069f5ed4-28a3-4957-be89-eaafe727bdc9",
"content": {
"graphic_objects": [
{
"shape": {
"text": {
"paragraphs": [
{
"id": "25dd5d7b-8324-50c2-b291-83e4441f62fd",
"portions": [
{
"style": {
"fontweight": "NORMAL"
},
"text": "Title placeholder"
}
]
}
],
"properties": {
"auto_fit": "TEXT"
}
},
"properties": {}
},
"id": "96408c29-0258-47b2-9001-1e4b073c369d"
},
{
"shape": {
"text": {
"paragraphs": [
{
"portions": [
{
"style": {}
}
]
}
],
"properties": {}
},
"properties": {}
},
"id": "4747910d-2315-438e-9a08-43e3036b56e9"
}
]
}
},
{
"slide_id": "212fd6b9-068b-4814-9a83-0904cf912f12",
"content": {
"graphic_objects": [
{
"shape": {
"text": {
"paragraphs": [
{
"id": "0aec1411-7fae-5570-b0f9-c95b074f63d8",
"portions": [
{
"style": {
"fontweight": "NORMAL"
},
"text": "Title placeholder"
}
]
}
],
"properties": {
"auto_fit": "TEXT"
}
},
"properties": {}
},
"id": "412ea216-fb8f-4ebc-8ff1-3d6b1ed2c399"
},
{
"shape": {
"text": {
"paragraphs": [
{
"portions": [
{
"style": {}
}
]
}
],
"properties": {}
},
"properties": {}
},
"id": "9ef7614f-6a81-41d3-808f-feb9f861804f"
}
]
}
},
{
"slide_id": "03e93b98-6010-4e3a-af16-3d07dd029bf9",
"content": {
"graphic_objects": [
{
"shape": {
"text": {
"paragraphs": [
{
"id": "eb26f1d1-8dcc-58df-8a8e-69f06ef41306",
"portions": [
{
"style": {
"fontweight": "NORMAL"
},
"text": "Title placeholder"
}
]
}
],
"properties": {
"auto_fit": "TEXT"
}
},
"properties": {}
},
"id": "9e772862-63f7-4a74-a355-3ba5ca38525e"
},
{
"shape": {
"text": {
"paragraphs": [
{
"portions": [
{
"style": {}
}
]
}
],
"properties": {}
},
"properties": {}
},
"id": "294ecca0-ab49-44ed-837f-a88b9e810beb"
}
]
}
},
{
"slide_id": "38282de1-f1fa-453d-8db1-ac2146492172",
"content": {
"graphic_objects": [
{
"shape": {
"text": {
"paragraphs": [
{
"id": "3f34797b-ab9c-505c-b802-9f7fb01201a7",
"portions": [
{
"style": {
"fontweight": "NORMAL"
},
"text": "Title placeholder"
}
]
}
],
"properties": {
"auto_fit": "TEXT"
}
},
"properties": {}
},
"id": "03f1923b-e796-464b-baf1-518798599326"
},
{
"shape": {
"text": {
"paragraphs": [
{
"portions": [
{
"style": {}
}
]
}
],
"properties": {}
},
"properties": {}
},
"id": "3e523c75-cfba-4b88-84d5-794c56f63040"
}
]
}
},
{
"slide_id": "3d698620-a19e-4aa3-aef2-e64f6a44a0ad",
"content": {
"graphic_objects": [
{
"shape": {
"text": {
"paragraphs": [
{
"id": "acef5c70-ca65-59c6-9754-5cd25b3db048",
"portions": [
{
"style": {
"fontweight": "NORMAL"
},
"text": "Title placeholder"
}
]
}
],
"properties": {
"auto_fit": "TEXT"
}
},
"properties": {}
},
"id": "84880583-5f6b-4cf2-9b1d-0b88efc0eeb5"
},
{
"shape": {
"text": {
"paragraphs": [
{
"portions": [
{
"style": {}
}
]
}
],
"properties": {}
},
"properties": {}
},
"id": "ea5f2ba1-6f0f-431a-a558-b76c643caba6"
}
]
}
},
{
"slide_id": "7bd6cb29-8448-408a-8d77-bc1ada743da5",
"content": {
"graphic_objects": [
{
"shape": {
"text": {
"paragraphs": [
{
"id": "80a4634a-9cff-5ce7-8f44-200524d2794c",
"portions": [
{
"style": {
"fontweight": "NORMAL"
},
"text": "Title placeholder"
}
]
}
],
"properties": {
"auto_fit": "TEXT"
}
},
"properties": {}
},
"id": "4365d876-dd2e-4e65-863a-3a823697e9ee"
},
{
"shape": {
"text": {
"paragraphs": [
{
"portions": [
{
"style": {}
}
]
}
],
"properties": {}
},
"properties": {}
},
"id": "b47a1432-4380-497e-895a-0a73368c1fc1"
}
]
}
},
{
"slide_id": "898b5311-e60a-42d0-8362-5d8938cfdf6c",
"content": {
"graphic_objects": [
{
"shape": {
"text": {
"paragraphs": [
{
"id": "af413603-3f63-5b48-ae40-7b52986deb5a",
"portions": [
{
"style": {
"fontweight": "NORMAL"
},
"text": "Title placeholder"
}
]
}
],
"properties": {
"auto_fit": "TEXT"
}
},
"properties": {}
},
"id": "29fe11d8-1157-44c5-91a3-23b8701c320c"
},
{
"shape": {
"text": {
"paragraphs": [
{
"portions": [
{
"style": {}
}
]
}
],
"properties": {}
},
"properties": {}
},
"id": "9686874f-a22f-4dda-97a2-3b0848f0ff33"
}
]
}
},
{
"slide_id": "87a4cdd5-a4b6-4cf8-b459-ba44ebed5b68",
"content": {
"graphic_objects": [
{
"shape": {
"text": {
"paragraphs": [
{
"id": "29bcb03d-1008-54b8-9cc9-38af28309290",
"portions": [
{
"style": {
"fontweight": "NORMAL"
},
"text": "Title placeholder"
}
]
}
],
"properties": {
"auto_fit": "TEXT"
}
},
"properties": {}
},
"id": "45405d52-84f4-48d0-9a27-a938cfcdf2a6"
},
{
"shape": {
"text": {
"paragraphs": [
{
"portions": [
{
"style": {}
}
]
}
],
"properties": {}
},
"properties": {}
},
"id": "575ea152-b2a9-435e-aaed-eb18847eb245"
}
]
}
}
]
},
"message": "Slide(s) content retrieved successfully",
"request_uri": "/api/v1/presentation/8i4vv3f345fcf907446a2bdc4e2c871fc585e/slides",
"status": "success"
}
Code Examples
cURL
curl -X GET "https://show.zoho.com/api/v1/presentation/{rid}/slides?ids={{ids}}&from=0&count=20" \
-H "Authorization: Zoho-oauthtoken YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json"
POST Insert Slides
POST https://show.zoho.com/api/v1/presentation/{rid}/slides
Required Scopes:
ZohoShow.showdocslist.CREATE
Creates one or more slides in a presentation. Use this endpoint to append new slides, or create slides with pre-populated graphic objects. Each entry in slides is a slide object. Do not send an id field in insert requests. Include layout_id when the slide should use a specific master layout.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
| rid | string | Required | Resource id of the presentation. The caller must have the appropriate permission on this presentation. |
Request Body
Interactive structure. Expand fields and select optional schema parts.
Samples
Request Body
JSON
{
"slides": [
{
"layout_id": "00000000-0000-4000-8000-000000000001"
}
]
}
Responses
200
Slides Inserted
400
Empty Request Data
400
Missing Slides
{
"data": {
"success_count": "1",
"failure_count": "0",
"results": [
{
"final_indices": [
"2"
],
"slide_ids": [
"8354a78a-1de9-4fce-8814-53e92f0d479d"
],
"slide_content": [
{
"orientation": "LANDSCAPE"
}
]
}
]
},
"message": "Slide(s) inserted successfully",
"request_uri": "/api/v1/presentation/8i4vv3f345fcf907446a2bdc4e2c871fc585e/slides",
"status": "success"
}
Code Examples
cURL
curl -X POST "https://show.zoho.com/api/v1/presentation/{rid}/slides" \
-H "Authorization: Zoho-oauthtoken YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"slides": [
{
"layout_id": "00000000-0000-4000-8000-000000000001"
}
]
}'
POST Duplicate Slides
POST https://show.zoho.com/api/v1/presentation/{rid}/slides/duplicate
Required Scopes:
ZohoShow.showdocslist.CREATE
Duplicates one or more existing slides in the same presentation. Use this endpoint to clone a slide as a starting point for a variant, repeat a template slide, or create multiple copies while preserving layout and object content. Each request names the source slide and may include a target insertion index or new slide name. The duplicated slide receives a new slide id, and objects inside the duplicate receive new object ids.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
| rid | string | Required | Resource id of the presentation. The caller must have the appropriate permission on this presentation. |
Request Body
Interactive structure. Expand fields and select optional schema parts.
Samples
Request Body
JSON
{
"requests": [
{
"source_slide_id": "11111111-1111-4111-8111-111111111111",
"insertion_target": {
"insert_index": 3
},
"slide_name": "Copy of Intro"
}
]
}
Responses
200
Slides Duplicated
400
Missing Requests
400
Missing Source Slide Id
400
Slide Not Found
{
"data": {
"summary": "Duplicated 1 of 1 slides",
"duplicated_count": "1",
"responses": [
{
"result": {
"source_slide_id": "54ca442b-63d1-43df-bda9-9f8cd2654e70",
"final_index": "0",
"duplicated_slide_id": "c7529308-7ade-483d-91e9-71eb1a976980"
}
}
],
"failed_count": "0",
"request_item_ids": [
"dup_0"
]
},
"message": "Slide(s) duplicated successfully",
"request_uri": "/api/v1/presentation/8i4vv3f345fcf907446a2bdc4e2c871fc585e/slides/duplicate",
"status": "success"
}
Code Examples
cURL
curl -X POST "https://show.zoho.com/api/v1/presentation/{rid}/slides/duplicate" \
-H "Authorization: Zoho-oauthtoken YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"requests": [
{
"source_slide_id": "11111111-1111-4111-8111-111111111111",
"insertion_target": {
"insert_index": 3
},
"slide_name": "Copy of Intro"
}
]
}'
PUT Update Slides
PUT https://show.zoho.com/api/v1/presentation/{rid}/slides
Required Scopes:
ZohoShow.showdocslist.UPDATE
Updates one or more existing slides. Use this endpoint to rename slides, change layout references, update orientation, or replace slide-level content represented by the SDK slide model. Each slide entry must include the target slide id. Send only the fields that need to change. Batch updates are processed per slide, and the response identifies which slide updates succeeded or failed.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
| rid | string | Required | Resource id of the presentation. The caller must have the appropriate permission on this presentation. |
Request Body
Interactive structure. Expand fields and select optional schema parts.
Samples
Request Body
JSON
{
"slides": [
{
"id": "11111111-1111-4111-8111-111111111111",
"name": "Renamed"
}
]
}
Responses
200
Slides Updated
400
Missing Slides
400
Missing Id
404
Slide Not Found
{
"data": {
"success_count": "1",
"failure_count": "0",
"results": [
{
"slide_content": [
{}
],
"slide_id": "54ca442b-63d1-43df-bda9-9f8cd2654e70"
}
]
},
"message": "Slide(s) updated successfully",
"request_uri": "/api/v1/presentation/8i4vv3f345fcf907446a2bdc4e2c871fc585e/slides",
"status": "success"
}
Code Examples
cURL
curl -X PUT "https://show.zoho.com/api/v1/presentation/{rid}/slides" \
-H "Authorization: Zoho-oauthtoken YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"slides": [
{
"id": "11111111-1111-4111-8111-111111111111",
"name": "Renamed"
}
]
}'
PUT Reorder Slides
PUT https://show.zoho.com/api/v1/presentation/{rid}/slides/reorder
Required Scopes:
ZohoShow.showdocslist.UPDATE
Moves one or more slides to new positions in the presentation. Use this endpoint for drag-and-drop slide sorting, generated agenda reordering, or moving imported slides into the right section. Each reorder request identifies a slide and the target insertion index. When multiple moves are sent together, order matters because earlier moves can affect later indexes. Refresh the slide list after the call to read the final order.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
| rid | string | Required | Resource id of the presentation. The caller must have the appropriate permission on this presentation. |
Request Body
Interactive structure. Expand fields and select optional schema parts.
Samples
Request Body
JSON
{
"requests": [
{
"slide_id": "11111111-1111-4111-8111-111111111111",
"target": {
"insert_index": 0
}
}
]
}
Responses
200
Slides Reordered
400
Missing Requests
400
Missing Slide Id
400
Missing Target
{
"data": {
"summary": "Reordered 1 of 1 slides",
"responses": [
{
"result": {
"final_index": "1",
"slide_id": "54ca442b-63d1-43df-bda9-9f8cd2654e70"
}
}
],
"reordered_count": "1",
"failed_count": "0",
"request_item_ids": [
"reorder_0"
]
},
"message": "Slide(s) reordered successfully",
"request_uri": "/api/v1/presentation/8i4vv3f345fcf907446a2bdc4e2c871fc585e/slides/reorder",
"status": "success"
}
Code Examples
cURL
curl -X PUT "https://show.zoho.com/api/v1/presentation/{rid}/slides/reorder" \
-H "Authorization: Zoho-oauthtoken YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"requests": [
{
"slide_id": "11111111-1111-4111-8111-111111111111",
"target": {
"insert_index": 0
}
}
]
}'
DELETE Remove Slides
DELETE https://show.zoho.com/api/v1/presentation/{rid}/slides
Required Scopes:
ZohoShow.showdocslist.DELETE
Deletes one or more slides from a presentation. Use this when slides should be removed from the deck, including all objects, notes, and layout bindings attached to those slides. Pass comma-separated slide UUIDs in ids. Deleting is permanent for the current document revision; list slides first if they need to confirm targets or preserve ordering context before deletion.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
| rid | string | Required | Resource id of the presentation. The caller must have the appropriate permission on this presentation. |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
| ids | string | Required | Comma-separated slide ids to delete. These ids select the objects to remove; the path parameters identify the container that holds them. |
Samples
Responses
200
Slides Deleted
400
Missing Ids
404
Slide Not Found
400
Invalid Ids
{
"data": {
"success_count": "1",
"failure_count": "0",
"results": [
{
"slide_id": "489f9fd2-a030-45a4-9b71-8aa7b7d4c226"
}
]
},
"message": "Slide(s) deleted successfully",
"request_uri": "/api/v1/presentation/8i4vv3f345fcf907446a2bdc4e2c871fc585e/slides",
"status": "success"
}
Code Examples
cURL
curl -X DELETE "https://show.zoho.com/api/v1/presentation/{rid}/slides?ids={{slide_id}}" \
-H "Authorization: Zoho-oauthtoken YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json"