---
title: "Update project configuration"
method: PUT
path: "/projects/{slug}/config"
tags: ["Projects"]
---

# Update project configuration

`PUT /projects/{slug}/config`

Update project.config.json. Only keys present in config are changed; other keys are preserved. Use this to define or update the project design system under tokens before styling slides. See getSlideGuide for token naming rules.

## Path parameters

- `slug` string, required

## Request body

- object
  - `config` object, required — Partial project config to merge into the existing file.
    - `layout` 'REGULAR' | 'CARD' | 'SLIDES' | 'SLIDESHOW' | 'STACKED'
    - `slidesDisplay` 'CARDS' | 'FULLSCREEN'
    - `stackedOrientation` 'VERTICAL' | 'HORIZONTAL'
    - `cardsSlidesPerView` number
    - `cardsBackgroundColor` string
    - `cardsBackgroundImage` string
    - `cardsCorners` 'ROUND' | 'SQUARE'
    - `showBrandLogo` boolean
    - `width` 'FULL' | 'MEDIUM' | 'COMPACT'
    - `mobileCanvas` 'LEGACY' | 'COMPACT'
    - `theme` object
      - `fontFamily` string, required
      - `headingFontFamily` string
      - `radius` string, required
      - `colors` object, required
        - `default` object, required
          - `background` string, required
          - `foreground` string, required
          - `card` string, required
          - `card-foreground` string, required
          - `card-border` string
          - `primary` string, required
          - `primary-foreground` string, required
          - `secondary` string, required
          - `secondary-foreground` string, required
          - `muted` string, required
          - `muted-foreground` string, required
          - `accent` string, required
          - `accent-foreground` string, required
          - `destructive` string, required
          - `destructive-foreground` string, required
          - `border` string, required
          - `input` string, required
          - `chart-1` string
          - `chart-2` string
          - `chart-3` string
          - `chart-4` string
          - `chart-5` string
        - `dark` object
          - `background` string, required
          - `foreground` string, required
          - `card` string, required
          - `card-foreground` string, required
          - `card-border` string
          - `primary` string, required
          - `primary-foreground` string, required
          - `secondary` string, required
          - `secondary-foreground` string, required
          - `muted` string, required
          - `muted-foreground` string, required
          - `accent` string, required
          - `accent-foreground` string, required
          - `destructive` string, required
          - `destructive-foreground` string, required
          - `border` string, required
          - `input` string, required
          - `chart-1` string
          - `chart-2` string
          - `chart-3` string
          - `chart-4` string
          - `chart-5` string
    - `tokens` object
      - `palette` object[]
        - `name` string, required
        - `value` string, required
      - `fonts` object[]
        - `name` string, required
        - `family` string, required
        - `url` string, uri

## Response `200`

Project configuration updated

- object
  - `versionId` string, required — The new project version ID.
  - `config` ProjectConfig, required — Project-level settings stored in project.config.json, including the shared design system. Color token names must start with --; font token names with --font-.
    - `layout` 'REGULAR' | 'CARD' | 'SLIDES' | 'SLIDESHOW' | 'STACKED'
    - `slidesDisplay` 'CARDS' | 'FULLSCREEN'
    - `stackedOrientation` 'VERTICAL' | 'HORIZONTAL'
    - `cardsSlidesPerView` number
    - `cardsBackgroundColor` string
    - `cardsBackgroundImage` string
    - `cardsCorners` 'ROUND' | 'SQUARE'
    - `showBrandLogo` boolean
    - `width` 'FULL' | 'MEDIUM' | 'COMPACT'
    - `mobileCanvas` 'LEGACY' | 'COMPACT'
    - `theme` object
      - `fontFamily` string, required
      - `headingFontFamily` string
      - `radius` string, required
      - `colors` object, required
        - `default` object, required
          - `background` string, required
          - `foreground` string, required
          - `card` string, required
          - `card-foreground` string, required
          - `card-border` string
          - `primary` string, required
          - `primary-foreground` string, required
          - `secondary` string, required
          - `secondary-foreground` string, required
          - `muted` string, required
          - `muted-foreground` string, required
          - `accent` string, required
          - `accent-foreground` string, required
          - `destructive` string, required
          - `destructive-foreground` string, required
          - `border` string, required
          - `input` string, required
          - `chart-1` string
          - `chart-2` string
          - `chart-3` string
          - `chart-4` string
          - `chart-5` string
        - `dark` object
          - `background` string, required
          - `foreground` string, required
          - `card` string, required
          - `card-foreground` string, required
          - `card-border` string
          - `primary` string, required
          - `primary-foreground` string, required
          - `secondary` string, required
          - `secondary-foreground` string, required
          - `muted` string, required
          - `muted-foreground` string, required
          - `accent` string, required
          - `accent-foreground` string, required
          - `destructive` string, required
          - `destructive-foreground` string, required
          - `border` string, required
          - `input` string, required
          - `chart-1` string
          - `chart-2` string
          - `chart-3` string
          - `chart-4` string
          - `chart-5` string
    - `tokens` object
      - `palette` object[]
        - `name` string, required
        - `value` string, required
      - `fonts` object[]
        - `name` string, required
        - `family` string, required
        - `url` string, uri

## Other responses

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

## Changes

- **2026-07-26** `f99acde20c79` — 2 info
  - added the new optional request property `config/allOf[#/components/schemas/ProjectConfig]/showBrandLogo`
  - added the optional property `config/showBrandLogo` to the response with the `200` status

[Change history](https://skmtc.dev/faces/apis/faces-api/changes/projects/:slug/config/put.md)

---

[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)