---
title: "Download a free ephemeral preview PNG"
method: GET
path: "/v1/previews/ephemeral/{path}"
tags: ["files"]
---

# Download a free ephemeral preview PNG

`GET /v1/previews/ephemeral/{path}`

## Request

- Base URL: `https://api.slideforge.dev`
- URL: `https://api.slideforge.dev/v1/previews/ephemeral/{path}`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Stream a playground preview image. Requires a valid HMAC signature (sig) and expiry (exp). Serves only ephemeral preview blobs — never invoices or deliverables.

## Path parameters

- `path` string, required

## Query parameters

- `sig` string, required: HMAC-SHA256 signature
- `exp` integer, required: Unix timestamp expiry

## Response `200`

PNG image

- unknown

## Other responses

- `403`: Invalid or expired signature
- `404`: Not found
- `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)
