Generate
Generate Slide(s)
Generate
Generate Slide(s)
The Generate Deck endpoint creates a slide deck based on user-defined parameters that specify its content and structure. Upon successful creation, the endpoint returns a link to the deck along with execution details. Unlike the POST /v3/generate/deck/task endpoint—which immediately returns a deck generation task for polling—this endpoint waits until the entire deck has been rendered before sending the response.
POST
Authorizations
The access token received from the authorization server in the OAuth 2.0 flow.
Body
application/json
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."
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"
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
Optional. An array of outline instructions defining the content and layout for each slide. See the /v3/generate/outline 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.
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"
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"
A list of email addresses that will have edit access to the generated Google Slides presentation. API user is included by default. Only applicable to Google Slides - ignored for PowerPoint.
Example:
["bob@acme.com", "joe@acme.com"]
Optional. A list of manual insertions of placeholder text into the generated deck. Useful for users who want to control the exact values of text placeholders in the slide. The placeholder must exist in the slides as Text Placeholder; therefore, we recommend using this text_placeholder_manual_insertions parameter when you know the placeholder values: template deck types and custom decks where the slide id is specified in the outline parameter. We support markdown content (lists, heading, bold, italics, underline, links, etc.)!
Example:
[
{
"placeholder": "[title]",
"slide_index": 0,
"value": "Renewable Energy Innovations 2025"
},
{
"placeholder": "[content]",
"slide_index": 1,
"value": "Introduce the topic of renewable energy and its importance."
}
]
Response
200
application/json
Successful Response
Unique identifier for the task instance of the deck generation.
Example:
"task_67890"
Time taken to generate the deck, in seconds.
Example:
4.3778
Indicates whether the deck generation was successful.
Example:
true
URL link to access the generated presentation deck.
Example:
"https://docs.google.com/presentation/d/abcdefg123456"
Error message in case the generation failed.
Example:
""