list_decorations
Filter your saved decoration library by content type, category, or tag to find reusable designs.
Instructions
List all saved decorations in the library.
Browse the decoration library to find reusable decorations.
Filter by content type, category, or tag.
:param content_type: Filter by type — ``photo``, ``svg``, ``qr``,
``text``, ``procedural_texture``, ``ai_texture``
(empty = show all).
:param category: Filter by category — ``surface`` (photo/svg/qr/text)
or ``texture`` (procedural/AI textures). Empty = show all.
:param tag: Filter by tag (empty = show all).
:returns: Dict with decoration count and list.
This is the decoration LIBRARY: keyed by name, and it ADAPTS —
each recorded success stores proven settings for THAT material,
so applying picks the depth and mode your prints proved for
whatever you are printing in now. It keeps no version history.
Kiln's other kind of saved decoration is a decoration PRESET
(kiln-pro; what the web's /decorations pages show): keyed by an
id because it has versions, branches and signed releases, and
applied at the exact settings its version recorded rather than
adapting to the material. Listed by ``list_decoration_presets``,
applied by ``apply_decoration_preset``. The library adapts, the
preset remembers — if what you want isn't here, look there.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tag | No | ||
| category | No | ||
| content_type | No |