POST/v1/templates/{id}

Update a template

Updates an existing template. Supply any template fields you want to change; if provided, status must be PUBLISHED or ARCHIVED. Each tag requires a title and a six-digit hexadecimal color.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

1 parameter · 9 body fields
idstringrequired
The unique identifier of the template to update.

Template fields to update; all fields are optional.

blogUrlstringoptional
A URL associated with the template's blog or related content.
categoriesarray<string>optional
Categories assigned to the template.
descriptionstringoptional
A description of the template.
flowsarray<object>optional
Flow definitions included in the template. Each flow requires `displayName`, `trigger`, and `valid`; it can also include `description`, `notes`, and `schemaVersion`.
metadataobjectoptional
Optional metadata associated with the template, or null.
namestringoptional
The template's name.
statusstringoptional
The template's status: `PUBLISHED` or `ARCHIVED`.
Allowed:PUBLISHEDARCHIVED
summarystringoptional
A short summary of the template.
tagsarray<object>optional
Tags assigned to the template. Each tag requires a `title` and a six-digit hexadecimal `color`; `icon` is

1 status code
200Returns the updated template.

Error handling

The id path parameter must identify the template to update. If supplied, status must be PUBLISHED or ARCHIVED; each flows item must include displayName, trigger, and valid, and each tags item must include title and a color matching # followed by six hexadecimal digits.