Skip to main content
POST
/
projects
/
{slug}
/
slides
Create a new slide
curl --request POST \
  --url https://faces.app/api/v1/projects/{slug}/slides \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Hero Section",
  "afterSlideId": "<string>",
  "editing": true
}
'
{
  "slideId": "<string>",
  "name": "<string>",
  "versionId": "<string>"
}

Authorizations

Authorization
string
header
required

API key with "faces_" prefix. Create one at Settings > Developers.

Path Parameters

slug
string
required

Body

application/json
name
string
required

Display name for the new slide.

Example:

"Hero Section"

afterSlideId
string

Insert after this slide ID. Omit to append at the end.

editing
boolean

If true, immediately shows the loading gradient on the new slide. Call finishSlideEditing when done.

Response

Slide created

slideId
string
required

The new slide ID.

name
string
required
versionId
string
required

The new project version ID.