Library

Decks published at renza.io/library — each a real hosted deck plus the prompt and style behind it. Reads are public and keyless. Submitting queues an entry for review; it does not publish. Every listing is reviewed by a person before it appears, and a listing pins the artifact version it was approved against, so later edits can't change what's shown.

Attributes

objectstringrequired
slugstringrequired
titlestringrequired
descriptionstringrequired
stylestring | nullrequired
Style slug, if the entry names one.
techniquesarray of stringrequired
promptstring | nullrequired
The prompt that produced it, verbatim.
provenanceobjectrequired
Honest provenance — which model, or written by hand. Never inferred.
urlstringrequired
deck_urlstring | nullrequired
The public share the entry links to; null if it was revoked.
created_atstringrequired

Endpoints

GET/v1/public/library
GET/v1/public/library/{slug}
GET/v1/library/pending
POST/v1/library

The LibraryListing object

{
  "object": "library_listing",
  "slug": "break-the-frame",
  "title": "Break the Frame",
  "description": "A nine-scene guide to putting video in an HTML deck, taught by a deck that demos it.",
  "style": "dark-moss",
  "techniques": [
    "alpha-video",
    "muted-autoplay"
  ],
  "provenance": {
    "model": "any",
    "note": "Hand-built, scene by scene"
  },
  "url": "https://renza.io/library/break-the-frame",
  "deck_url": "https://renza.io/v/X3k9…x",
  "created_at": "2026-08-13T10:30:00.000Z"
}

List Library entries (no auth)

GET/v1/public/library

Public. The approved entries at renza.io/library — each a real hosted deck plus the prompt and style behind it. No API key required.

Public — no authentication required.

Keyless — the Library is a public web surface.

Query parameters

stylestringoptional
Only entries cut in this style.

Returns

200The approved entries.

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

Terminal

renza library list

GET /v1/public/library

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

TypeScript

import { createRenzaClient } from "renza-sdk";

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

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

Response 200

{
  "object": "list",
  "url": "/v1/public/library",
  "data": [
    {
      "object": "library_listing",
      "slug": "break-the-frame",
      "title": "Break the Frame",
      "description": "A nine-scene guide to putting video in an HTML deck, taught by a deck that demos it.",
      "style": "dark-moss",
      "techniques": [
        "alpha-video",
        "muted-autoplay"
      ],
      "provenance": {
        "model": "any",
        "note": "Hand-built, scene by scene"
      },
      "url": "https://renza.io/library/break-the-frame",
      "deck_url": "https://renza.io/v/X3k9…x",
      "created_at": "2026-08-13T10:30:00.000Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Get a Library entry (no auth)

GET/v1/public/library/{slug}

Public. One approved entry. Unknown or unapproved slugs return 404 — a pending submission is not discoverable through this endpoint.

Public — no authentication required.

Path parameters

slugstringrequired

Returns

200The entry.

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

Terminal

renza library get break-the-frame

GET /v1/public/library/{slug}

curl https://api.renza.io/v1/public/library/break-the-frame

TypeScript

import { createRenzaClient } from "renza-sdk";

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

const entry = await renza.library.get("break-the-frame");

Response 200

{
  "object": "library_listing",
  "slug": "break-the-frame",
  "title": "Break the Frame",
  "description": "A nine-scene guide to putting video in an HTML deck, taught by a deck that demos it.",
  "style": "dark-moss",
  "techniques": [
    "alpha-video",
    "muted-autoplay"
  ],
  "provenance": {
    "model": "any",
    "note": "Hand-built, scene by scene"
  },
  "url": "https://renza.io/library/break-the-frame",
  "deck_url": "https://renza.io/v/X3k9…x",
  "created_at": "2026-08-13T10:30:00.000Z"
}

List submissions awaiting review

GET/v1/library/pending

Your org's Library submissions that haven't been decided yet. The review queue is normally delivered by email; this is the pull-based view for when mail isn't available, and the way to confirm a submission actually landed.

Requires an API key (bearer), scoped to the active org.

Returns

200Pending submissions.

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

Terminal

renza library pending

GET /v1/library/pending

curl https://api.renza.io/v1/library/pending \
  -H "Authorization: Bearer $RENZA_API_KEY"

TypeScript

import { createRenzaClient } from "renza-sdk";

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

const entry = await renza.library.pending();

Response 200

{
  "object": "list",
  "url": "/v1/public/library",
  "data": [
    {
      "object": "library_listing",
      "slug": "break-the-frame",
      "title": "Break the Frame",
      "description": "A nine-scene guide to putting video in an HTML deck, taught by a deck that demos it.",
      "style": "dark-moss",
      "techniques": [
        "alpha-video",
        "muted-autoplay"
      ],
      "provenance": {
        "model": "any",
        "note": "Hand-built, scene by scene"
      },
      "url": "https://renza.io/library/break-the-frame",
      "deck_url": "https://renza.io/v/X3k9…x",
      "created_at": "2026-08-13T10:30:00.000Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Submit a deck to the Library

POST/v1/library

Submits one of your decks for listing at renza.io/library. Creates a PENDING entry and notifies a reviewer — it does not publish. Every listing is reviewed before it appears, permanently: an approved entry sits on Renza's domain under Renza's SEO. The listing pins the deck's current artifact version, so later edits don't change what was approved. Re-submitting a listed deck updates the entry and returns it to review.

Requires an API key (bearer), scoped to the active org. Supports idempotency keys.

Body parameters

deckstringrequired
Deck id or external id.
descriptionstringrequiredmax 400 chars
What this deck is and why its design works. Shown on the entry.
titlestringoptionalmax 200 chars
Defaults to the deck's title.
stylestringoptional
A slug from GET /v1/public/styles.
techniquesarray of stringoptional
promptstringoptionalmax 20000 chars
The prompt that produced the deck.
provenance_modelstringoptionalmax 120 chars
Which model made it, or omit if hand-written. Stated, never inferred.
provenance_notestringoptionalmax 400 chars

Returns

202Queued for review.

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

Terminal

renza library submit deck_2a9f8c1b --style dark-moss

POST /v1/library

curl https://api.renza.io/v1/library \
  -H "Authorization: Bearer $RENZA_API_KEY" \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{
  "deck": "deck_2a9f8c1b",
  "style": "dark-moss",
  "techniques": [
    "alpha-video"
  ],
  "provenance_model": "any"
}'

TypeScript

import { createRenzaClient } from "renza-sdk";

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

const entry = await renza.library.submit({
  deck: "deck_2a9f8c1b",
  style: "dark-moss",
  techniques: ["alpha-video"],
  provenance_model: "any",
});

Response 202

{
  "object": "library_listing_submission",
  "id": "lib_5d2a…",
  "slug": "break-the-frame",
  "status": "pending",
  "message": "Submitted for review — it appears in the Library once approved."
}