presentations

Add, change or delete blocks

Change some blocks of a slide and leave the others alone, in one step: "add": new blocks [{"type", "props"}] (placed on top, or at the bottom with "at_bottom": true); "update": [{"id", "props"}] -- only the given props change. The same props for several blocks at once, like selecting them in the editor: {"ids": [...], "props"}; or for a card and everything drawn on it: {"inside": <id of the card's background block>, "props"} -- that block and every block lying within its rectangle (props a block type does not have, like "link" of a code block, are skipped for it); "delete": [block ids]. Returns the slide (ids only unless "response" is "full").

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

Request

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

Path parameters

slugstring required

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

slide_idinteger required

The id of a slide (stable, the "id" of the slide in the presentation). Its number (position) changes when slides are reordered.

Request body

addobject[]

New blocks: [{"type", "props"}].

updateobject[]

Changes: [{"id" | "ids": [...] | "inside": <card block id>, "props"}].

deleteinteger[]

Ids of blocks to delete.

at_bottomboolean

Put the added blocks under the others (default: on top).

base_versionstring

Optional: the "version" of the slide as you read it. The change is refused (409 conflict) when somebody changed the slide meanwhile, instead of overwriting their work.

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.