# LLM Resources (/docs/llm-resources)



## Overview [#overview]

These resources provide machine-readable versions of our documentation, optimized for Large Language Models (LLMs) and AI tools to efficiently process and understand the SlidesGPT API.

## Available Formats [#available-formats]

<Cards>
  <Card title="Documentation Index" href="/llms.txt">
    **llms.txt** - Structured index of all documentation pages with descriptions
  </Card>

  <Card title="Full Documentation" href="/llms-full.txt">
    **llms-full.txt** - Complete documentation content in a single file
  </Card>
</Cards>

## What are these files? [#what-are-these-files]

### llms.txt [#llmstxt]

The `llms.txt` file is an industry standard that helps LLMs index content more efficiently, similar to how a sitemap helps search engines. It contains:

* Site title as an H1 heading
* Structured content sections with links
* Description of each page from frontmatter

### llms-full.txt [#llms-fulltxt]

The `llms-full.txt` file combines your entire documentation site into a single file as context for AI tools. It provides:

* Complete documentation content in one place
* Full context for comprehensive answers
* Cross-references between different sections
* Preserved structure and formatting

## Benefits [#benefits]

<Cards>
  <Card title="Faster AI Responses">
    LLMs can quickly locate and process relevant content
  </Card>

  <Card title="Better Accuracy">
    Structured format improves comprehension and response quality
  </Card>

  <Card title="Always Up-to-Date">
    Automatically regenerated whenever documentation changes
  </Card>

  <Card title="Zero Maintenance">
    No manual updates required - generated directly from the docs content
  </Card>
</Cards>

## How AI Tools Use These Files [#how-ai-tools-use-these-files]

1. **Discovery**: AI tools automatically find these files at standard URLs
2. **Indexing**: Content is processed and indexed for efficient retrieval
3. **Context Building**: Full documentation provides comprehensive understanding
4. **Query Processing**: Structured format enables accurate responses

## For Developers [#for-developers]

If you're building AI-powered tools that need to understand the SlidesGPT API:

* Use `/docs/llms.txt` for quick navigation and page discovery
* Use `/docs/llms-full.txt` for complete context and detailed information
* Append `.md` to any docs page URL to get its raw markdown
* Both files follow the industry-standard llms.txt specification

<Callout title="Note">
  These files are generated automatically and are always in sync with the
  latest documentation.
</Callout>


# Authentication (/docs/getting-started/authentication)



To use the **SlidesGPT API**, you need an API key for authentication. This key must be included in every request as a Bearer token in the `Authorization` header.

### How to Get an API Key [#how-to-get-an-api-key]

<Steps>
  <Step>
    Sign up or log in to [SlidesGPT](https://slidesgpt.com).
  </Step>

  <Step>
    Navigate to the [API Keys](https://slidesgpt.com/keys) page.

    <img width="265" height="200" src="/docs/static/images/authentication/1.png" alt="Authentication 1" />
  </Step>

  <Step>
    Generate a new API key.

    <img width="540" height="200" src="/docs/static/images/authentication/2.png" alt="Authentication 2" />
  </Step>

  <Step>
    Optionally, give your key a name.

    <img width="504" height="200" src="/docs/static/images/authentication/3.png" alt="Authentication 3" />
  </Step>

  <Step>
    Save your key.

    <img width="310" height="200" src="/docs/static/images/authentication/4.png" alt="Authentication 4" />
  </Step>
</Steps>

### Using the API Key [#using-the-api-key]

Include it in your request headers:

```
Authorization: Bearer YOUR_API_KEY
```

Keep your key secure and do not share it.


# Custom Templates (/docs/getting-started/custom-templates)



## Overview [#overview]

Custom templates allow you to use your own PowerPoint template designs when generating presentations. Upload your branded template once, then use it across unlimited presentations.

## How It Works [#how-it-works]

1. **Upload** your PowerPoint template (.pptx)
2. **Get** a unique template ID
3. **Generate** presentations using your template ID
4. Your presentations will automatically use your custom design

## Quick Start [#quick-start]

<Steps>
  <Step>
    ### Upload Your Template [#upload-your-template]

    Upload your branded PowerPoint file on SlidesGPT:

    <Card title="Upload" href="https://slidesgpt.com/templates">
      Upload Custom Template
    </Card>
  </Step>

  <Step>
    ### Generate with Custom Template [#generate-with-custom-template]

    Use the template ID from step 1:

    ```bash
    curl -X POST https://api.slidesgpt.com/v1/presentations/generate \
      -H "Authorization: Bearer YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "prompt": "Q4 Business Review",
        "templateId": "4a8ec7b3-c043-4d15-88e3-7d63803878f4"
      }'
    ```
  </Step>

  <Step>
    ### Download Your Branded Presentation [#download-your-branded-presentation]

    Your presentation will use your custom design, colors, fonts, and layouts!
  </Step>
</Steps>

## Requirements [#requirements]

* **File Format**: `.pptx` only
* **File Size**: Maximum 50MB
* **Fonts**: Use web-safe fonts or embed fonts in the file

## Best Practices [#best-practices]

<Cards>
  <Card title="Store Template IDs">
    Save template IDs in your database and reuse them across presentations.
  </Card>

  <Card title="One Upload">
    Upload once, use unlimited times - no need to re-upload.
  </Card>
</Cards>

## Code Examples [#code-examples]

<Tabs items="[&#x22;JavaScript&#x22;, &#x22;Python&#x22;, &#x22;cURL&#x22;]">
  <Tab value="JavaScript">
    ```javascript
    // Generate with template
    const generateResponse = await fetch(
      "https://api.slidesgpt.com/v1/presentations/generate",
      {
        method: "POST",
        headers: {
          Authorization: "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
        },
        body: JSON.stringify({
          prompt: "Q4 Business Review",
          templateId: templateId,
        }),
      },
    );

    const presentation = await generateResponse.json();
    ```
  </Tab>

  <Tab value="Python">
    ```python
    import requests

    # Generate with template
    generate_response = requests.post(
        'https://api.slidesgpt.com/v1/presentations/generate',
        headers=headers,
        json={
            'prompt': 'Q4 Business Review',
            'templateId': template_id,
        }
    )

    presentation = generate_response.json()
    ```
  </Tab>

  <Tab value="cURL">
    ```bash
    # Generate with template
    curl -X POST https://api.slidesgpt.com/v1/presentations/generate \
      -H "Authorization: Bearer YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d "{
        \"prompt\": \"Q4 Business Review\",
        \"templateId\": \"$TEMPLATE_ID\"
      }"
    ```
  </Tab>
</Tabs>

## Next Steps [#next-steps]

<Cards>
  <Card title="List Endpoint" href="/api-reference/endpoint/list-templates">
    API reference for listing templates
  </Card>

  <Card title="Generate with Template" href="/api-reference/endpoint/generate">
    Generate presentations with custom templates
  </Card>

  <Card title="Support" href="https://slidesgpt.com/p/contact">
    Need help? Contact our team
  </Card>
</Cards>


# Deleting a Presentation (/docs/getting-started/delete-presentation)



The **SlidesGPT API** allows you to delete a generated presentation permanently. Once deleted, the presentation cannot be recovered.

### Request Example [#request-example]

Send a `DELETE` request to:

```
https://api.slidesgpt.com/v1/presentations/{id}
```

#### Sample Code (cURL) [#sample-code-curl]

```sh
curl -X DELETE "https://api.slidesgpt.com/v1/presentations/12345" \
     -H "Authorization: Bearer YOUR_API_KEY"
```

#### Sample Code (JavaScript) [#sample-code-javascript]

```js
async function deletePresentation(id) {
  try {
    const response = await fetch(`${API_BASE_URL}/presentations/${id}`, {
      method: "DELETE",
      headers: { Authorization: `Bearer ${token}` },
    });
    if (response.ok) console.log("Presentation deleted successfully.");
    else console.error("Failed to delete presentation.");
  } catch (err) {
    console.error(err);
  }
}
```

<Callout title="Note">
  You must include your API key in the `Authorization` header. If you don't
  have one, follow the steps in the [Authentication
  Guide](/getting-started/authentication) to get your API key.
</Callout>

Use this API call carefully, as deletions are **irreversible**.


# Downloading a Presentation (/docs/getting-started/download-presentation)



The **SlidesGPT API** allows you to download a generated presentation as a PowerPoint (`.pptx`) file.

### Request Example [#request-example]

Send a `GET` request to:

```
https://api.slidesgpt.com/v1/presentations/{id}/download
```

#### Sample Code (JavaScript) [#sample-code-javascript]

```js
import fs from "fs";

async function downloadPresentation(id) {
  try {
    const response = await fetch(`${API_BASE_URL}/presentations/${id}/download`, {
      method: "GET",
      headers: { Authorization: `Bearer ${token}` },
    });
    const buffer = await response.arrayBuffer();
    fs.writeFileSync(`presentation-${id}.pptx`, Buffer.from(buffer));
  } catch (err) {
    console.error(err);
  }
}
```

This function fetches the `.pptx` file and saves it locally.

#### Sample Code (wget) [#sample-code-wget]

```sh
wget --header="Authorization: Bearer YOUR_API_KEY" \
     -O presentation.pptx \
     "https://api.slidesgpt.com/v1/presentations/12345/download"
```

<Callout title="Note">
  You must include your API key in the `Authorization` header. If you don't
  have one, follow the steps in the [Authentication
  Guide](/getting-started/authentication) to get your API key.
</Callout>


# Embedding a Presentation (/docs/getting-started/embed-presentation)



The **SlidesGPT API** provides an easy way to embed presentations using Microsoft PowerPoint Online. The `embed` route returns a **redirect response** to the PowerPoint Online viewer.

### Request Example [#request-example]

Send a `GET` request to:

```
https://api.slidesgpt.com/v1/presentations/{id}/embed
```

#### Sample Code (cURL) [#sample-code-curl]

```sh
curl -X GET "https://api.slidesgpt.com/v1/presentations/12345/embed" \
     -H "Authorization: Bearer YOUR_API_KEY"
```

<Callout title="Note">
  You must include your API key in the `Authorization` header. If you don't
  have one, follow the steps in the [Authentication
  Guide](/getting-started/authentication) to get your API key.
</Callout>

### Behavior [#behavior]

This request **does not return JSON**. Instead, it redirects the user to PowerPoint Online, where the presentation can be viewed.

<Callout title="Note">
  You can directly use this endpoint in an `<iframe>` or redirect users in your
  application.
</Callout>


# Generating a Presentation (/docs/getting-started/generate-presentation)



With the **SlidesGPT API**, you can create a presentation by sending a request with a prompt. The API will generate slides based on your input.

### Request Example [#request-example]

Send a `POST` request to:

```
https://api.slidesgpt.com/v1/presentations/generate
```

#### Sample Code (cURL) [#sample-code-curl]

```sh
curl -X POST "https://api.slidesgpt.com/v1/presentations/generate" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{"prompt": "Introduction to Machine Learning"}'
```

#### With Custom Template (Optional) [#with-custom-template-optional]

To use your own branded PowerPoint template, include a `templateId` in your request. Learn how to upload and manage custom templates in our [Custom Templates Guide](/getting-started/custom-templates).

```sh
curl -X POST "https://api.slidesgpt.com/v1/presentations/generate" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "prompt": "Introduction to Machine Learning",
       "templateId": "YOUR_TEMPLATE_ID"
     }'
```

#### Sample Code (JavaScript) [#sample-code-javascript]

```js
async function generatePresentation(prompt, templateId = null) {
  const body = { prompt };
  if (templateId) body.templateId = templateId; // Add custom template ID

  const response = await fetch("https://api.slidesgpt.com/v1/presentations/generate", {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json"
    },
    body: JSON.stringify(body)
  })
  return response.json();
}

// Generate with default theme
await generatePresentation("Introduction to Machine Learning");

// Generate with custom template
await generatePresentation("Q4 Business Review", "YOUR_TEMPLATE_ID");
```

<Callout title="Note">
  You must include your API key in the `Authorization` header. If you don't
  have one, follow the steps in the [Authentication
  Guide](/getting-started/authentication) to get your API key.
</Callout>

<Callout title="Tip" type="info">
  Want to use your company's branded templates? Check out our [Custom Templates
  Guide](/getting-started/custom-templates) to learn how to upload and use your
  own PowerPoint designs.
</Callout>

### Response Example [#response-example]

```json
{
  "id": "123",
  "embed": "https://api.slidesgpt.com/123/embed",
  "download": "https://api.slidesgpt.com/123/download"
}
```

You can use the `embed` link to preview the presentation or download the PowerPoint file.


# Introduction (/docs/getting-started/introduction)



This API allows you to generate presentations instantly using AI. Whether you need a quick slideshow for a meeting, a classroom lesson, or a business pitch, SlidesGPT simplifies the process.

With just a single request, you can create a structured and visually appealing presentation, eliminating the hassle of manual slide creation.

Start automating your presentations today and let AI handle the heavy lifting!

For more details, explore the [API reference](/api-reference/endpoint/generate).


# Delete a presentation (/docs/api-reference/endpoint/delete)



{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}



# Download a presentation (/docs/api-reference/endpoint/download)



{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}



# Get embed URL for a presentation (/docs/api-reference/endpoint/embed)



{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}



# Generate a presentation (/docs/api-reference/endpoint/generate)



{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}



# Get a presentation (/docs/api-reference/endpoint/get)



{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}



# List Templates (/docs/api-reference/endpoint/list-templates)



## `GET /v1/templates` [#get-v1templates]

Retrieve all custom templates you've uploaded.

## Request [#request]

<Tabs items="[&#x22;cURL&#x22;, &#x22;JavaScript&#x22;, &#x22;Python&#x22;]">
  <Tab value="cURL">
    ```bash
    curl https://api.slidesgpt.com/v1/templates \
      -H "Authorization: Bearer YOUR_API_KEY"
    ```
  </Tab>

  <Tab value="JavaScript">
    ```javascript
    const response = await fetch("https://api.slidesgpt.com/v1/templates", {
      headers: { Authorization: "Bearer YOUR_API_KEY" },
    });

    const templates = await response.json();
    ```
  </Tab>

  <Tab value="Python">
    ```python
    import requests

    headers = {'Authorization': 'Bearer YOUR_API_KEY'}
    response = requests.get(
        'https://api.slidesgpt.com/v1/templates',
        headers=headers
    )

    templates = response.json()
    ```
  </Tab>
</Tabs>

## Response [#response]

Returns an array of template objects.

| Field       | Type     | Description                         |
| ----------- | -------- | ----------------------------------- |
| `id`        | `string` | Unique identifier for the template  |
| `createdAt` | `string` | ISO 8601 timestamp of when uploaded |

```json title="Response"
[
  {
    "id": "4a8ec7b3-c043-4d15-88e3-7d63803878f4",
    "createdAt": "2025-11-18T18:08:25.000Z"
  },
  {
    "id": "7b2cd9e1-f234-4a56-b789-c123d456e789",
    "createdAt": "2025-11-17T14:22:10.000Z"
  }
]
```