> ## Documentation Index
> Fetch the complete documentation index at: https://faces.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Slides

> Create one or more empty slides in a project in a single atomic call.



## OpenAPI

````yaml POST /projects/{slug}/slides
openapi: 3.1.0
info:
  title: Faces API
  version: '1.0'
  description: >-
    Faces API for creating and managing presentations. Generate presentations
    from prompts, or read and write individual slides. Each slide is a React
    component (face.tsx) with content blocks (face.content.json) and editor
    controls (face.controls.json).
servers:
  - url: https://faces.app/api/v1
    description: API v1
security:
  - bearerAuth: []
paths:
  /projects/{slug}/slides:
    post:
      tags:
        - Slides
      summary: Create one or more slides
      description: >-
        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.
      operationId: createSlides
      parameters:
        - schema:
            type: string
          required: true
          name: slug
          in: path
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                slides:
                  type: array
                  items:
                    type: object
                    properties:
                      name:
                        type: string
                        description: Display name for the new slide.
                        example: Hero Section
                    required:
                      - name
                  minItems: 1
                  description: >-
                    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.
                afterSlideId:
                  type: string
                  description: >-
                    Insert the new slides immediately after this slide ID. Omit
                    to append at the end.
                editing:
                  type: boolean
                  description: >-
                    If true, immediately shows the loading gradient on every new
                    slide. Call finishSlideEditing on each when done.
              required:
                - slides
      responses:
        '200':
          description: Slides created
          content:
            application/json:
              schema:
                type: object
                properties:
                  slides:
                    type: array
                    items:
                      type: object
                      properties:
                        slideId:
                          type: string
                          description: The new slide ID.
                        name:
                          type: string
                      required:
                        - slideId
                        - name
                    description: >-
                      The newly created slides, in the same order they were
                      requested.
                  versionId:
                    type: string
                    description: The new project version ID.
                required:
                  - slides
                  - versionId
        '400':
          description: Validation error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Project not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - bearerAuth: []
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: string
        hint:
          type: string
      required:
        - error
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key with "faces_" prefix. Create one at Settings > Developers.

````