> ## 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 Project

> Create a new blank project. Add slides with Create Slide + Update Slide.



## OpenAPI

````yaml POST /projects
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:
    post:
      tags:
        - Projects
      summary: Create a blank project
      description: >-
        Create a new empty project. The project is created under the team your
        API key is scoped to (you choose this when creating the key). Returns
        the projectSlug and editorUrl. Add slides with createSlides +
        updateSlide.
      operationId: createProject
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  minLength: 1
                  maxLength: 200
                  description: Optional display name. Defaults to 'Untitled'.
      responses:
        '200':
          description: Project created
          content:
            application/json:
              schema:
                type: object
                properties:
                  projectId:
                    type: string
                  projectSlug:
                    type: string
                  projectVersionId:
                    type: string
                  editorUrl:
                    type: string
                    format: uri
                required:
                  - projectId
                  - projectSlug
                  - projectVersionId
                  - editorUrl
        '400':
          description: Validation error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Authentication required
          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.

````