templates

Save a render template

Save a set of render settings — the look, the voice, the length, the shape — under a name, so every render after this one can ask for it by id. Nothing here is a lock: a template is a set of DEFAULTS and any render may override any of them. At most 50 per account; the 51st is 409 template_limit.

post/templates

Request

  • Base URL: https://api.gogoscreen.com/api/v1
  • URL: https://api.gogoscreen.com/api/v1/templates
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Headers

Idempotency-Keystring required

1–128 characters, unique to this request. A retry with the same key and the same body returns the STORED response with Idempotent-Replayed: true; the same key with a different body is 409 idempotency_conflict; a duplicate still in flight is 409 idempotency_in_progress. Claims expire after 24 hours.

Request body

descriptionstring
namestring required
settingsobject

Omit for a template that pins nothing but its name.

sourceRenderIdstring uuid

A finished render of this account's that these settings were taken from, for your own records. A render id that is not this account's is a 404.

Response

Save a render template

Changes

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