---
title: "Widget thumbnail (PNG) from blob storage"
method: GET
path: "/v1/widgets/{name}/preview"
tags: ["catalog", "discovery"]
---

# Widget thumbnail (PNG) from blob storage

`GET /v1/widgets/{name}/preview`

## Request

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

Pre-rendered thumbnail of the widget/primitive drawn from its worked example on a neutral 16:9 slide (generated by scripts/ssg/publish_widget_thumbnails.py). Sizes: full (~1920px), sm (~480px). No auth.

## Path parameters

- `name` string, required

## Query parameters

- `size` string: full | sm

## Response `200`

Successful Response

- unknown

## Other responses

- `404`: Preview not available
- `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)