Skip to main content
POST
Generate a project

Authorizations

Authorization
string
header
required

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

Body

application/json
prompt
string
required

A detailed description of the project to generate.

Minimum string length: 1
Example:

"5-slide pitch deck about AI in healthcare with a modern dark theme"

templateId
string

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.

Response

Job created

jobId
string
required

Poll this ID with the status endpoint.

status
enum<string>
required
Available options:
processing
editorUrl
string<uri>
required

URL to open the project in the Faces editor.

estimatedDuration
string
required

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

Example:

"240 seconds"

templateId
string