---
title: "Code-mode widget + chart-primitive catalog"
method: GET
path: "/v1/widgets"
tags: ["catalog", "discovery"]
---

# Code-mode widget + chart-primitive catalog

`GET /v1/widgets`

## Request

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

The board-grade widgets and chart primitives drawable via `add_widget()` in `mode=code` (`/v1/render/code`). Grid by default (every name + a one-liner); `?name=<widget>` returns the full contract — docstring, param/content schema, and a worked example. REST mirror of MCP `browse_catalog(type=widgets)`. Free, no auth.

## Query parameters

- `name` string, nullable: A widget/primitive name for its full contract

## Response `200`

Successful Response

- unknown

## Other responses

- `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)