Update a template

PUT/api/templates/{id}

Renames a template, or changes its description or category.

Needs an API token with the Write permission for workflows (workflow:write).

Parameters

Path

idRequired · UUID: The template’s ID.

Body

All three are set as sent: leaving out description or category clears it.

nameRequired · string: Required: up to 255 characters, and not blank.
descriptionOptional · string: Trimmed. Left out: cleared.
categoryOptional · string: Trimmed. Left out: cleared.

Its steps

The steps can’t be sent here. Update a template’s steps copies them from a workflow. It takes no Idempotency-Key.

Responses

200OK
The template as it is now.
400VALIDATION_ERROR
The body isn’t JSON, or the name is blank or over 255 characters.
403FORBIDDEN
The token lacks the Write permission for workflows, or the token’s owner may not change it. Only its creator, an organization admin, or for a workspace’s own template that workspace’s admin.
404NOT_FOUND
No template with this ID in this workspace. A template the installation shares is changed only in the Platform console, and reads as not found here.
500INTERNAL_ERROR
Nothing changed. Try again.

Any call can also answer: 401 UNAUTHORIZED · 401 TOKEN_ENDED · 403 TOKEN_SURFACE_OFF · 403 FEATURE_OFF · 403 EMBED_NOT_ALLOWED · 403 EMBED_NOT_AVAILABLE · 403 ACCOUNT_SUSPENDED · 413 PAYLOAD_TOO_LARGE · 415 INVALID_CONTENT_TYPE · 429 RATE_LIMITED · 503 BUSY · 503 PAUSED · 503 SERVICE_UNAVAILABLE. See Errors.

Request

GORUNNER="https://api.gorunner.io"
GORUNNER_TOKEN="grt_…"  # needs Write for workflows
TEMPLATE_ID="your-template-id"

curl -X PUT "$GORUNNER/api/templates/$TEMPLATE_ID" \
  -H "Authorization: Bearer $GORUNNER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Order intake v2",
    "description": "Webhook to fulfilment.",
    "category": "Sales"
  }'

const GORUNNER = "https://api.gorunner.io";
const TOKEN = process.env.GORUNNER_TOKEN;
const TEMPLATE_ID = process.env.TEMPLATE_ID;

const res = await fetch(
  `${GORUNNER}/api/templates/${TEMPLATE_ID}`,
  {
    method: "PUT",
    headers: {
        Authorization: `Bearer ${TOKEN}`,
        "Content-Type": "application/json",
      },
    body: JSON.stringify({
        name: "Order intake v2",
        description: "Webhook to fulfilment.",
        category: "Sales",
      }),
  },
);
const { data } = await res.json();

import os, requests

GORUNNER = "https://api.gorunner.io"
TOKEN = os.environ["GORUNNER_TOKEN"]
TEMPLATE_ID = os.environ["TEMPLATE_ID"]

res = requests.put(
    f"{GORUNNER}/api/templates/{TEMPLATE_ID}",
    headers={"Authorization": f"Bearer {TOKEN}"},
    json={
      "name": "Order intake v2",
      "description": "Webhook to fulfilment.",
      "category": "Sales",
    },
)
data = res.json()["data"]

Response · 200 OK, shortened

json

{
  "data": {
    "id": "9c4e2a17-3d5b-4f86-b0e2-8a1c7d3f5e29",
    "scope": "org",
    "name": "Order intake v2",
    "description": "Webhook to fulfilment.",
    "category": "Sales",
    "updatedAt": "2026-10-20T08:00:00Z"
  }
}

Every field

Body

nameRequired · string: Required, and not blank: a name that is empty after trimming is refused with 400 VALIDATION_ERROR, as is one over 255 characters.
descriptionOptional · string: Trimmed. Omitting it clears the stored description.
categoryOptional · string: Trimmed. Omitting it clears the stored category.

Response · 200 OK

dataobject

A template with its definition: an immutable snapshot of a workflow’s draft taken when it was saved (or its steps last updated). A copy, never a live link: workflows made from it are not affected by changing or deleting it.

idUUID

scopestring

Who sees it: org — an organization’s, every workspace of it; workspace — a customer account’s, the workspace it was saved in only; installation — shared by the installation with its customer accounts (listed only in a customer account, and only while the license has embedding), read-only here.

One of org, workspace, installation.

keystring

An installation template’s stable handle. Absent on every other template.

namestring

descriptionstring

What it does, as saved. May be empty: whenLine then describes it.

categorystring

Free-text grouping label; empty when none.

triggerTypestring

createdAttime

updatedAttime

publishedAttime

When an installation template was first offered. Absent on every other template.

readableboolean

false: its definition cannot be read. Such a row is listed only to someone who may delete it (canManage), with everything derived from the definition empty.

authorobject or null

Who saved it; null for an installation template.

idUUID or null

namestring or null

Their name, else their email; null once the account is deleted.

leftboolean

They are no longer a member of this organization.

sourceobject or null

An installation template’s origin; null otherwise.

organizationstring

The organization it was shared from; empty once that organization is gone.

savedHereboolean

It was saved in this workspace. Otherwise its bound values arrive blank (see TemplateFillField).

savedInstring or null

The workspace it was saved in (an installation template: the organization it was shared from); null when not recorded.

sourceWorkflowobject or null

The workflow it was saved (or last updated) from, while that workflow exists and is in this workspace.

idUUID

namestring

triggerobject or null

namestring

displayNamestring

pieceIdstring

actionIdstring

marksarray of strings

App ids in run order: the trigger’s, then one per step (branch steps branch, loops loop, a Code step code), never de-duplicated.

stepsarray of objects

Every step, in the order of marks after the trigger.

namestring

displayNamestring

pieceIdstring

actionIdstring

typestring

One of PIECE, CODE, BRANCH, LOOP.

depthinteger

0 at the top level; one more inside a branch arm, a loop body or an error path.

whenLinestring

A generated line for a template without a description: how it starts, then its first three steps’ names.

slotsarray of objects

The connections a workflow made from it needs, one per service account.

keystring

pieceIdstring

The connection’s app (what GET /api/connections rows carry).

pieceNamestring

stepsarray of strings

stepLabelsarray of strings

connectionIdstring or null

The connection the template’s own steps name; null for an installation template or none.

toFillinteger

How many values using it here will ask for: required fields left blank and bound values blanked here.

availableboolean

unavailableobject or null

Why it cannot be used on this installation.

codestring

One of PIECE_UNAVAILABLE, STEP_INCOMPLETE, ACTION_UNAVAILABLE, UNREADABLE.

messagestring

stepstring

The step it is about, by name.

usesobject or null

Workflows of this organization made from it, and how many are live. Sent only to its author, an organization admin or a platform admin.

workflowsinteger

liveinteger

canManageboolean

The caller may rename, update the steps of and delete it: its creator, an organization admin, or for a workspace template that workspace’s admin.

createdByUUID

Who saved it, as before the Templates redesign (author names them). Absent on an installation template and when the account is gone.

definitionobject

A workflow definition — the same document the workflow API uses (schemaVersion is 2). It is a TREE, not a list: trigger is the root and each node chains onward through nextAction; branches[].firstAction and firstLoopAction hold nested sub-chains, and onErrorAction holds a step’s error arm. A step’s settings live in config, never settings. The trigger names its trigger in a field called actionId, and trigger type is lowercase while action type is UPPERCASE (PIECE, BRANCH, LOOP, CODE). A step that uses credentials carries connectionId — a bare connection id, workspace-scoped, which is why it may be cleared when the template is used in another workspace.

A workflow definition: its fields are in Workflow definition.

blankedarray of objects

Only on a save’s and an update of the steps’ answers: each value the copy left out (a credential typed into a step).

stepstring

The step’s name (the trigger’s own name for the trigger).

stepLabelstring

The step as the canvas names it.

fieldstring

The top-level input key.

fieldLabelstring

The app’s title for the input.

Update a template

Parameters

Path

Body

Its steps

Responses

Body

Response · 200 OK

Panel