Manage decks

Create deck

Creates a new deck.

post/v1/decks

Request

  • Base URL: https://api.slides.com
  • URL: https://api.slides.com/v1/decks
  • 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)

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 and slide_ids in presentation order, without HTML, notes, or CSS. Use the Get slide endpoint to retrieve content. Validation failures return an error.

dataunknown required
metaobject

Changes

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