v4

latestOpenAPI 3.1.02026-08-0130252.8 KB

Projects

Generate a project

Generate a new project from a text prompt using AI. Returns a job ID to poll with Get job status until it completes.

post/projects/generate

Request body

promptstring required

A detailed description of the project to generate.

templateIdstring

ID of one of your team's templates to base the project on. The template's design is preserved exactly and its slides are reproduced with your content. Only team templates are supported.

referenceImageUrlsstring[]

Public image URLs to use as visual inspiration.

model'google/gemini-3.6-flash' | 'openai/gpt-5.6-sol:xhigh'

Generation model. Defaults to Gemini 3.6 Flash.

Example request

{
  "prompt": "5-slide pitch deck about AI in healthcare with a modern dark theme"
}

Response

Job created

jobIdstring required

Poll this ID with the status endpoint.

status'processing' | 'completed' | 'failed' required

editorUrlstring uri nullable required

URL to open the project in the Faces editor.

estimatedDurationstring required

Estimated generation time. ~120s with a team template, 240s from scratch.

projectIdstring nullable required

projectSlugstring nullable required

templateIdstring

Example response

{
  "estimatedDuration": "240 seconds"
}