Delete a template
Requires scope
workflow:writePermanently deletes the template. Workflows previously created from it are UNAFFECTED — a template is a copy, never a live reference.
AUTHORIZATION IS TWO-LAYER: the route needs workflow:write, and the handler additionally requires the caller to be the template's CREATOR or to hold org:manage.
Authorization
bearerAuth AuthorizationBearer <token>
An API token: Authorization: Bearer grt_…. Mint one in the app under Settings → Workspace → API tokens; the raw value is shown once. Scopes confine the token — see x-permission on each operation.
In: header
Path Parameters
id*string
The template's UUID. A value that is not a valid UUID answers 404 on the template routes, not 400.
Format
uuidResponse Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X DELETE "https://example.com/api/templates/497f6eca-6276-4993-bfeb-53cbbbba6f08"{ "data": { "message": "Template deleted" }}