Show the existing public link without issuing a new one

get/presets/{id}/share

Request

  • Base URL: https://rendry.io/api/v1
  • URL: https://rendry.io/api/v1/presets/{id}/share
  • Auth: one of:
    • 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

Current public URL, if any — {enabled: false} when there is none

enabledboolean required

true while the link is open; {enabled: false} is the whole reply of a closed link

urlstring

Path of the public picture, /u/{token}.png — prefix https://rendry.io; absent while closed. Template variables go on as query parameters (example shows this template's own); a parameter named after a computed value overrides it

daily_render_budgetinteger

NEW pictures this link may render a day; cached variants are free

rotatedboolean

POST only: true when rotate: true issued a NEW url and killed the previous one; false when the reply re-reports the live url (opening an open link never replaces it)

hintstring

POST only: how to use the link

examplestring

POST only: the url with this template's own first variable and its sample as a query parameter (the same example share_preset_url gives); the bare url when the template has no variables

variablesstring[]

Present with inputs: the names a caller supplies — not the computed ones, which a value sent under their name overrides for the call.

Changes

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