---
title: "Add several slides"
method: POST
path: "/api/v1/presentations/{slug}/slides/batch"
tags: ["presentations"]
---

# Add several slides

`POST /api/v1/presentations/{slug}/slides/batch`

## Request

- Base URL: `https://easeweb.host`
- URL: `https://easeweb.host/api/v1/presentations/{slug}/slides/batch`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `sessionid`

Add several slides at once to a presentation you may edit, at the end or from "position" (1-based) on. Each slide is
{"name", "w", "h", "bg", "fit", "transition", "transition_duration", "background", "objects": [blocks]}. A link {"kind": "slide", "slide_number": N} counts
the slides of the presentation as they are after the insertion, so new slides may lead to each other.
Returns the new slides (ids only unless "response" is "full").

## Path parameters

- `slug` string, required: The presentation's slug (its address: /movie/<slug>/).

## Request body

- object
  - `position` integer: 1-based place of the first new slide; default: the end.
  - `slides` object[], required: The slides: [{"name", "w", "h", "bg", "fit", "transition", "transition_duration", "background", "objects"}].
    - `name` string: Slide name (at most 100 characters), in the language of the presentation.
    - `name_tr` object: The slide name in the other languages of the site: {"en": "..."}.
    - `w` integer: Canvas width in px (200-4000, default 1280).
    - `h` integer: Canvas height in px (default 720).
    - `bg` string: Background colour, #rrggbb.
    - `fit` 'contain' | 'cover' | 'stretch': How the background picture fits.
    - `transition` 'none' | 'fade' | 'slide-left' | 'slide-right' | 'zoom': Entrance effect of this incoming slide (default: none).
    - `transition_duration` integer: Animation duration in milliseconds (100-3000, default 500); not auto advance. Values outside the range are clamped.
    - `background` string, nullable: Background picture: the "src" of an uploaded picture; null removes it.
    - `objects` object[]: Blocks of the slide, bottom to top: [{"type": "text"|"shape"|"button"|"line"|"image"|"code", "props": {...}}]. Missing props take the presentation theme's defaults (every prop is described in the block format reference). A link to a slide of the same presentation may be given as {"kind": "slide", "slide_number": N}.
  - `response` 'brief' | 'full': "brief" (default): only the ids, numbers and types of the slides and blocks; "full": every prop of every block too.

## Response `200`

OK

- object

## Other responses

- `4XX`: Error

---

[API](https://skmtc.dev/easeweb/apis/easeweb-presentations-api.md) · [All operations](https://skmtc.dev/easeweb/apis/easeweb-presentations-api/llms.txt) · [OpenAPI document](https://skmtc.dev/easeweb/apis/easeweb-presentations-api/revisions/9f5566adb5d1?raw)