Activepieces Management Octri Preview
POST/v1/templates

Create a template

Creates a new template from the supplied details. Provide name, summary, description, author, categories, and type; type must be OFFICIAL, SHARED, or CUSTOM. Include flows and tags to provide flow definitions and tag metadata with the template.

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

10 body fields

Template details. name, summary, description, author, categories, and type are required.

authorstringrequired
The template author's name or identifier.
blogUrlstringoptional
A URL associated with the template's blog or related content.
categoriesarray<string>required
Categories assigned to the template.
descriptionstringrequired
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.
namestringrequired
The template's name.
summarystringrequired
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
typestringrequired
The template type: `OFFICIAL`, `SHARED`, or `CUSTOM`.
Allowed:OFFICIALSHAREDCUSTOM

1 status code
200Returns the created template.

Error handling

name, summary, description, author, categories, and type are required. type must be one of OFFICIAL, SHARED, or CUSTOM; each flows item must include displayName, trigger, and valid, and each tags item must include title and a six-digit hexadecimal color.