> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flashdocs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart - Custom Deck Generation

> In this page, we do a super quick demonstration of how to create a custom deck.

Creating a custom deck is perfect for use cases where you want to create a presentation with a variable number of slides (depending on the prompt). If you have a repeated deck creation use case, where you want the same set slides but with content tailored to the prompt, you should create a deck from a `template`.

<Tip>
  You can view your available FlashDocs templates and libraries here: [dash.flashdocs.ai](https://dash.flashdocs.ai)
</Tip>

# Hello World

Below is the simplest deck generation request we can make. Just specify a prompt and the backend takes care of the rest.

```bash
curl --request POST \
  --url https://api.flashdocs.ai/v3/generate/deck \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Make a slide deck explaining why programmatic slide deck creation is a game changer for my business. Describe all of the new features we can add."
}'
```

<Card title="Generate Slides Endpoint" icon="rocket" href="https://docs.flashdocs.com/api-reference/generate/generate-deck?playground=open">
  View the API Reference
</Card>

# Overview of Custom Deck Generation Process

<Steps>
  <Step title="Slide Source: The request does not specify a source_document_id, so the system fetches any (Google Slides / PPTX) library document that is in your organization." />

  <Step title="Slide Count: The request does not specify a number of slides (number_slides), so the system estimates an appropriate number of slides based on the prompt." />

  <Step title="Outline Generation: The request does not specify an outline, so the system creates an outline (content & slide layout description for each slide) based on the slide count and prompt." />

  <Step title="Slide Selection: The request does not include an outline parameter with the slide_id key, so the system selects the most relevant slide from the slide source (library document in step 1) given the outline layout description for each slide." />

  <Step title="Generation: For each selected slide, the system uses the prompt + outline + placeholders in the slide to generate content for each of the selected slides." />
</Steps>

# Want More Configuration Options?

<Note>
  Complete Generation Control. If you want to see more details on how you can completely control the deck generation through the various parameters: [Generation Walkthrough](https://docs.flashdocs.com/generation-walkthrough)
</Note>
