---
title: "Update deck"
method: PATCH
path: "/v1/decks/{id}"
tags: ["Manage decks"]
---

# Update deck

`PATCH /v1/decks/{id}`

## Request

- Base URL: `https://api.slides.com`
- URL: `https://api.slides.com/v1/decks/{id}`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://slides.com/oauth/authorize`, token URL `https://slides.com/oauth/token`, scopes: `manage`)

Updates selected fields on an owned deck.

## Path parameters

- `id` union, required
  - string
  - integer

## Request body

- object
  - `title` string: Deck title.
  - `description` string: Deck description.
  - `width` integer: Canvas width in pixels. Defaults to 1280 on creation.
  - `height` integer: Canvas height in pixels. Defaults to 720 on creation.
  - `margin` number: Viewport margin factor from 0 to 1; defaults to 0 on creation. Reserves space around the presentation during scaling, not padding inside the slide.
  - `theme_color` 'white-blue' | 'sand-blue' | 'beige-brown' | 'silver-green' | 'silver-blue' | 'sky-blue' | 'blue-yellow' | 'cobalt-orange' | 'asphalt-orange' | 'forest-yellow' | 'mint-beige' | 'sea-yellow' | 'yellow-black' | 'coral-blue' | 'grey-blue' | 'black-blue' | 'black-mint' | 'black-orange': Presentation color preset. Defaults to white-blue on creation. [View color presets](https://slides.com/docs/presentation-styles#color-presets).
  - `theme_font` 'montserrat' | 'league' | 'opensans' | 'josefine' | 'palatino' | 'news' | 'helvetica' | 'merriweather' | 'asul' | 'sketch' | 'quicksand' | 'overpass2': Presentation font preset. Defaults to montserrat on creation. [View font presets](https://slides.com/docs/presentation-styles#font-presets).
  - `visibility` 'all' | 'self' | 'team': Deck visibility. Team accounts may also use team visibility.

## Response `200`

Returns deck metadata without HTML, notes, or CSS. Use get_deck with include_deck_html to retrieve HTML. Read-only keys and validation failures return an error.

- ApiResponse
  - `data` unknown, required
  - `meta` object

## Other responses

- `401`: A valid API key or OAuth access token is required.
- `403`: The credential or account cannot perform this operation.
- `404`: The requested resource was not found.
- `422`: The request parameters or body are invalid.
- `429`: The request rate limit was exceeded.

---

[API](https://skmtc.dev/slides/apis/slides-rest-api.md) · [All operations](https://skmtc.dev/slides/apis/slides-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/slides/apis/slides-rest-api/revisions/7d5a371a6715?raw)