---
title: "Create one or more slides"
method: POST
path: "/projects/{slug}/slides"
tags: ["Slides"]
---

# Create one or more slides

`POST /projects/{slug}/slides`

Create one or more empty slides in order in a single atomic call. Returns the new slideIds in the order they were created. Always batch every slide you want to add into one call instead of calling this endpoint multiple times concurrently. After creation, call updateSlide on each returned slideId to write real content.

## Path parameters

- `slug` string, required

## Request body

- object
  - `slides` object[], required — Ordered list of slides to create. The first entry is inserted immediately after afterSlideId (or at the end if omitted); each subsequent entry is inserted after the previous one.
    - `name` string, required — Display name for the new slide.
  - `afterSlideId` string — Insert the new slides immediately after this slide ID. Omit to append at the end.
  - `editing` boolean — If true, immediately shows the loading gradient on every new slide. Call finishSlideEditing on each when done.

## Response `200`

Slides created

- object
  - `slides` object[], required — The newly created slides, in the same order they were requested.
    - `slideId` string, required — The new slide ID.
    - `name` string, required
  - `versionId` string, required — The new project version ID.

## Other responses

- `400` — Validation error
- `404` — Project not found

---

[API](https://skmtc.dev/faces/apis/faces-api.md) · [All operations](https://skmtc.dev/faces/apis/faces-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/faces/faces-api/revisions/83197d741969/schema)