Task templates
Task templates are ready-made tasks you start in one click. Browse, search and star them, and create, edit, duplicate and delete your organization's own.
List templates
Lists the published templates you can start: every global template, plus your organization's own when its plan includes them. With `q`, only matching templates, best match first; otherwise grouped by purpose, then by name. At most 200.
Create template
Creates a template, a draft unless sent as published. A global template needs the operator; your organization's own needs permission to edit templates and a plan that includes them, else 403.
List templates to manage
Lists every template you can edit, drafts included, with its starts in the last 90 days. With `q`, only matching templates, best match first; otherwise grouped by purpose, then by name, at most 200. Returns 403 if you can edit none.
Check template references
Returns, for each id, whether the template can still be started (`ok`), is gone (`deleted`) or exists but cannot be started by your organization (`unavailable`). Another organization's template carries no name.
Delete template
Permanently deletes a template you can edit. Tasks started from it keep its name. Returns 204 with no body.
Get template
Returns one template with the task it creates. A draft is returned to its editors only; another organization's template returns 404.
Update template
Changes the fields sent on a template you can edit. Publishing needs a summary, a title and a description.
Upload template asset
Uploads one image to a template you edit, as multipart `kind` and `file`. A `card_image` (PNG, JPEG, WebP or SVG, at most 2 MB) replaces the template's card image; a `body_image` (PNG, JPEG, GIF or WebP, at most 10 MB) is named in the body as `attachment:<filename>`. Returns 413 over the limit, 415 for another type, else the image with status 201.
Delete template asset
Removes one image from a template you edit; removing the card image leaves the purpose placeholder. Tasks that copied the image keep it. Returns 204 with no body.
Get template image
Returns one image of a template you can see: a redirect to the image, or an SVG served under a policy that runs no script. Another organization's template returns 404.
Duplicate template
Copies a global template or one of your organization's own into a new draft of your organization's. Requires permission to edit templates and a plan that includes them.
Unfavorite template
Removes your star from a template. Returns 204 with no body.
Favorite template
Stars a template for you alone. Returns 204 with no body.
Get template usage
Returns how many automations name a template and how many tasks were started from it in the last 90 days, for a delete confirmation. Requires permission to edit the template.