# slides

Each **`slide`** object will result in a single slide in the output presentation. Multiple **`slide`** objects may point to the same template slide number, in which case that template slide will be reused multiple times.

<table><thead><tr><th width="142">Parameter</th><th width="129">Type</th><th width="94">Input</th><th>Description</th></tr></thead><tbody><tr><td>slide_index</td><td>Integer</td><td>int </td><td><mark style="color:red;">[required if <code>slide_id</code> not provided]</mark> Slide template number to use. Zero-based.</td></tr><tr><td>slide_id</td><td>Integer</td><td>int</td><td><mark style="color:red;">[required if <code>slide_index</code>  not provided]</mark> A unique identifier of a given slide. This ID is not displayed in the document, it's hidden in the xml. </td></tr><tr><td>shapes</td><td><mark style="color:blue;">Object</mark></td><td></td><td><mark style="color:yellow;">[optional]</mark> An array of shape objects. See <a href="shapes/textbox"><mark style="color:blue;"><strong>textbox</strong></mark></a>, <a href="shapes/table"><mark style="color:blue;"><strong>table</strong></mark></a>, <a href="shapes/chart"><mark style="color:blue;"><strong>chart</strong></mark></a>, <a href="shapes/picture"><mark style="color:blue;"><strong>image</strong></mark></a><mark style="color:blue;"><strong>.</strong></mark></td></tr><tr><td>notes</td><td>String or <mark style="color:blue;">Object</mark></td><td></td><td><p><mark style="color:yellow;">[optional]</mark> Represents slide notes. </p><p></p><p>- <strong>String</strong>: A simple way to display plain text in the slide notes.</p><p></p><p>- <strong>Object</strong>: Use for advanced formatting by defining text chunks. See the <a href="#text-object"><mark style="color:blue;"><strong>text object</strong></mark></a> structure.</p></td></tr><tr><td>tags </td><td><mark style="color:blue;">Object</mark></td><td></td><td><mark style="color:yellow;">[optional]</mark> An array of <a href="tags"><mark style="color:blue;"><strong>tag objects</strong></mark></a><mark style="color:blue;"><strong>.</strong></mark> Shorthand way of updating keys (text) with values on a slide level. </td></tr></tbody></table>

JSON payload

{% code lineNumbers="true" %}

```json
"slides": [
 {
   "slide_index": int,
   "shapes": [],
   "notes": string,
   "tags": []
 },
 {
   "slide_id": int,
   "shapes": [],
   "notes": [],
   "tags": []
 }
]
```

{% endcode %}