# Download a slideshow

> Download a slideshow with the Wavegrain Carousel API: POST /api/v1/slideshows/{id}/export. Parameters, responses and an example request.

> Index of these docs: https://wavegrain.com/developers/llms.txt

`POST /api/v1/slideshows/{id}/export` is part of the [Carousel API](/developers/carousel-api). Every call needs an access key: see [Authentication](/developers/authentication).

Needs the `write` permission. A short-lived link to a ZIP of the slide images at the slideshow's size, which works without a key. Refused while a slide has no image or text does not fit; `message` names the slides.

## Parameters

| Name | In | Type | Required | Notes |
| --- | --- | --- | --- | --- |
| `id` | path | string | yes |  |

## Example request

```bash
curl -X POST https://wavegrain.com/api/v1/slideshows/ID/export \
  -H "Authorization: Bearer $WAVEGRAIN_KEY"
```

## Responses

| Status | Meaning |
| --- | --- |
| 200 | The ZIP link. |
| 401 | No access key, or an unknown, revoked or expired one |
| 403 | The key lacks the permission, or the account has no active plan |
| 404 | No such slideshow of yours. |
| 409 | It cannot export yet; the message names the slides. |
| 429 | Too many requests for the key or the account |
| 500 | Something went wrong on Wavegrain's side; try again, and send the request id if it keeps failing. |

A successful answer:

```json
{
  "slideshowId": "ses_Ry4kP2",
  "downloadUrl": "https://wavegrain.com/api/export/ses_Ry4kP2?download=eyJzIjoic2VzX1J5NGtQMiJ9",
  "expiresAt": "2026-11-12T11:00:00.000Z",
  "caption": "Three ways to keep rice fluffy. Save this for later.",
  "slideCount": 6
}
```

## More in the Carousel API

- [Estimate a slideshow's price](/developers/api/estimate-slideshow): `POST /api/v1/slideshows/estimate`
- [Make a slideshow from a topic](/developers/api/create-slideshow): `POST /api/v1/slideshows`
- [List slideshows](/developers/api/list-slideshows): `GET /api/v1/slideshows`
- [Make a slideshow in a post's look](/developers/api/copy-post): `POST /api/v1/slideshows/copies`
- [Follow a slideshow job](/developers/api/get-job): `GET /api/v1/jobs/{id}`
- [Get a slideshow](/developers/api/get-slideshow): `GET /api/v1/slideshows/{id}`
- [All endpoints](/developers/api)
