Styles

Design languages you can apply to a deck — palette, type, grid, motion, and what to avoid, as a markdown spec. Public and keyless, so an agent can fetch one before its user has an account. Renza never restyles a deck itself: you hand the spec to your own model, it rewrites the HTML, and you publish the result.

Attributes

objectstringrequired
slugstringrequired
namestringrequired
familystringrequired
Possible values: dark, light, editorial, technical, expressive
summarystringrequired
versionintegerrequired
Contract version. Moves when a section is renamed, reordered, or removed.
urlstringrequired

Endpoints

GET/v1/public/styles
GET/v1/public/styles/{slug}

The Style object

{
  "object": "style",
  "slug": "dark-moss",
  "name": "Dark Moss",
  "family": "dark",
  "summary": "A deep, desaturated green-black with warm off-white text and one moss accent.",
  "version": 1,
  "url": "https://renza.io/library/styles/dark-moss"
}

List design styles (no auth)

GET/v1/public/styles

Public. The design languages a deck can be cut in — each a spec an agent applies to a deck it is already writing. Summaries only; fetch one to get its spec. No API key required.

Public — no authentication required.

Keyless — an agent can browse styles before its user has an account.

Query parameters

familystringoptional
Narrow to one family — a browsing filter, not a taxonomy.
Possible values: dark, light, editorial, technical, expressive

Returns

200The available styles.

Failures use the standard error envelope with a closed set of codes.

Terminal

renza styles list

GET /v1/public/styles

curl https://api.renza.io/v1/public/styles

TypeScript

import { createRenzaClient } from "renza-sdk";

const renza = createRenzaClient({ apiKey: process.env.RENZA_API_KEY! });

const page = await renza.styles.list();

Response 200

{
  "object": "list",
  "url": "/v1/public/styles",
  "data": [
    {
      "object": "style",
      "slug": "dark-moss",
      "name": "Dark Moss",
      "family": "dark",
      "summary": "A deep, desaturated green-black with warm off-white text and one moss accent.",
      "version": 1,
      "url": "https://renza.io/library/styles/dark-moss"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Get a design style (no auth)

GET/v1/public/styles/{slug}

Public. Returns the style with its full markdown spec. Pass `?format=md` (or send `Accept: text/markdown`) to get the raw markdown instead of the JSON envelope — that is the form to hand to a model. Renza never applies a style itself; the caller's own model does the rewrite and publishes the result. No API key required.