Rename, re-describe or re-categorize a template
workflow:writeUpdates ONLY the three presentation fields — name, description, category. The definition is an immutable snapshot with no parameter here; a template can never be re-pointed at a different flow. To capture new content, save a new template.
All three are applied as sent (values are trimmed): omitting description or category CLEARS them rather than preserving them. Send the current values to keep them.
AUTHORIZATION IS TWO-LAYER: the route needs workflow:write, and on top of that the handler requires the caller to be the template's CREATOR or to hold org:manage. Anyone else gets 403 even with workflow:write.
Returns the template as re-read after the write.
Does NOT accept Idempotency-Key.
Authorization
bearerAuth 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
The template's UUID. A value that is not a valid UUID answers 404 on the template routes, not 400.
uuidRequest Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Only these three presentation fields are updatable. The definition is immutable and has no parameter. Each field is applied as sent, so omitting description or category CLEARS it.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X PUT "https://example.com/api/templates/497f6eca-6276-4993-bfeb-53cbbbba6f08" \ -H "Content-Type: application/json" \ -d '{ "name": "Order intake v2", "description": "Webhook to parsed order", "category": "Sales" }'{ "data": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "createdBy": "25a02396-1048-48f9-bf93-102d2fb7895e", "name": "string", "description": "string", "category": "string", "triggerType": "string", "definition": { "schemaVersion": 2, "trigger": {}, "variables": {}, "settings": {} }, "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z" }}