Manage decks

Update deck

Updates selected fields on an owned 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)

Path parameters

string required
OR
integer required

ID of the deck.

Request body

titlestring

Deck title.

descriptionstring

Deck description.

widthinteger

Canvas width in pixels. Defaults to 1280 on creation.

heightinteger

Canvas height in pixels. Defaults to 720 on creation.

marginnumber

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.

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.

visibility'all' | 'self' | 'team'

Deck visibility. Team accounts may also use team visibility.

Response

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.

dataunknown required
metaobject

Changes

No recorded changes to this operation across all 1 revision of this API.