Get full template (canvas + layers)

Layers reveal {variable} placeholders and dynamic image keys — everything render_image accepts in dynamic_data.

get/presets/{id}

Request

  • Base URL: https://rendry.io/api/v1
  • URL: https://rendry.io/api/v1/presets/{id}
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer
    • HTTP bearer
    • HTTP bearer

Path parameters

idstring required

Headers

X-Rendry-Accountstring

Browser/OAuth current member account selector. API keys/embed credentials are bound to their persisted account and reject another account. Omitting this header selects the browser actor personal account.

Response

The stored template. With a group id the latest version comes back; ?exact=true returns exactly the version whose id was passed.

idstring

This version's id; changes on every saved version

user_idstring
preset_group_idstring

The template's id, stable across versions — what /render/*, PATCH, /share and DELETE /presets/{id}/group take

parent_idstring

The version this one was saved over or forked from

namestring
descriptionstring
preview_keystring

Storage key of the server-made preview picture; fetch it as /files/{preview_key}

version_notestring

Label of an explicitly marked version; routine saves carry none

layersobject[]

Ordinary DSL layers; text layers may opt into document continuation with text_flow (see TextFlow). The authoritative native text_flows receipt is returned before charge in dry runs.

modificationsobject

Sample values of the {variables}: the defaults of every render that omits a key

variable_modesobject

How each modifications source is read; a missing name is text

sample_rowsobject

Sample rows of repeat groups and tables; a call's rows override them

derivedobject[]

Colours derived from an image layer, as in PresetInput

palettesobject

Colours a field takes from data, as in PresetInput

variable_formatsobject nullable

Sparse name -> display format beside modifications and variable_modes. A name needs a source in modifications and cannot be page, pages or row.*. Applied after source evaluation and also to caller overrides; formulas consume raw exact values while templates insert formatted text. Invalid schema refuses save; invalid data refuses dry run and render before any charge, without echoing values. update_preset patches: absent or {} keeps; name:null removes; top-level null clears. Whole preset and document saves replace the map.

Changes

No recorded changes to this operation across all 1 revision of this API.