Skip to main content
POST
Generate Slide(s) Via Task (Async)

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json
prompt
string | null

The main (ideally information dense) instructions for how to create the slide(s). Can be ~400,000 characters.

Example:

"In a few slides, describe the recent Innovations in Renewable Energy. Discuss the foundational problems and key papers. Include specific examples."

source_document_id
string | null

Optional. The FlashDocs document ID of an existing source document to base the presentation content on. See the results from https://api.flashdocs.ai/v1/documents/base - the id key in the document object. If not provided, then any Library document in the organization is chosen.

Example:

"abc-def-ghi-jkl"

number_slides
integer | null

Optional. The desired number of slides in the generated presentation. If not provided, the system will automatically predict the number of slides from the prompt. Do not include if source_document_id is a template document.

Example:

5

audience_domain
string | null

Optional. Used to populate image placeholders with the audience-company-logo category. I.e. if this is a slide deck for an external audience, the audience_domain is the website of the company that the audience belongs to. If not provided, the system will predict. Must be valid domain name (ex: if you are making a deck to sell your product to the finance team at Intel, set this parameter to intel.com or https://intel.com)

Example:

"slack.com"

presentation_name
string | null

Optional. The desired filename name for the generated presentation deck. If not provided, the system will generate one based on the prompt.

Example:

"Renewable Energy Innovations 2025"

outline
DeckOutlineItem · object[] | null

Optional. An array of outline instructions defining the content and layout for each slide. See the endpoint for details. Only used for custom decks - ignored for template decks. Useful when you want specific content & layouts for each slide in a custom deck. If not provided, then the system will generate an outline using the prompt.

export_options
ExportOptions · object | null

Optional. Export options for the generated presentation. Only applicable to Google Slides - ignored for PowerPoint.

Example:

Response

Successful Response

task_id
string
required

Unique identifier for the task instance of the deck generation.

Example:

"task_67890"

created_at
string

Creation timestamp