presentations

Add a slide

Add a slide to a presentation you may edit, at the end or at "position" (1-based), optionally with its blocks right away. Returns the new slide (ids only unless "response" is "full").

post/api/v1/presentations/{slug}/slides

Request

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

Path parameters

slugstring required

The presentation's slug (its address: /movie/<slug>/).

Request body

positioninteger

1-based place; default: the end.

namestring

Slide name (at most 100 characters), in the language of the presentation.

name_trobject

The slide name in the other languages of the site: {"en": "..."}.

winteger

Canvas width in px (200-4000, default 1280).

hinteger

Canvas height in px (default 720).

bgstring

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_durationinteger

Animation duration in milliseconds (100-3000, default 500); not auto advance. Values outside the range are clamped.

backgroundstring nullable

Background picture: the "src" of an uploaded picture; null removes it.

objectsobject[]

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

OK

object required

Changes

No recorded changes to this operation across all 1 revision of this API.