---
title: "Compile slides into a deck"
method: POST
path: "/v1/compile"
tags: ["compile"]
---

# Compile slides into a deck

`POST /v1/compile`

## Request

- Base URL: `https://api.slideforge.dev`
- URL: `https://api.slideforge.dev/v1/compile`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Merge multiple slides into a single PPTX deck. Returns 202 with job_id -- poll GET /v1/jobs/{id} for the deck URL.

## Request body

- CompileRequest: POST /v1/compile request body.
  - `job_ids` string[], required
  - `title` string, nullable
  - `author` string, nullable
  - `slide_numbers` boolean

## Response `200`

Successful Response

- unknown

## Other responses

- `202`: Compile job queued
- `400`: No job_ids provided or too many (max 50)
- `422`: Validation Error

---

[API](https://skmtc.dev/slideforge/apis/slideforge-api.md) · [All operations](https://skmtc.dev/slideforge/apis/slideforge-api/llms.txt) · [OpenAPI document](https://skmtc.dev/slideforge/apis/slideforge-api/revisions/ae698e3d3c00?raw)
