GoRunner docs
Search or askSearch⌘K

List templates customers can install

GET/api/embed/v1/templates

Lists the templates you share with every customer, newest first, with the apps and connections each needs.

Needs a partner key: Authorization: Bearer gre_…, from Platform › Partner keys. Call it from your server only.

Embed · Self-hosted with an Embed license

Parameters

Query

cursorOptional · string

The pagination.nextCursor of the page before. Left out: the first page.

limitOptional · integer

Rows a page, 1 to 100. The default is 50.

Read a row

key is what you install by. connections lists one slot per service the steps need, with the steps that use it. An account whose app list leaves out one of pieces can’t install it.

You share a template from a workflow’s ⋯ in Workflows: Share with customers…. See Templates for customers.

Responses

Any call can also answer: 401 UNAUTHORIZED · 403 EMBED_NOT_LICENSED · 403 IP_NOT_ALLOWED · 429 RATE_LIMITED · 503 BUSY. See Errors.

Request

GORUNNER="https://automations.example.com"
GORUNNER_EMBED_KEY="YOUR_PARTNER_KEY"  # gre_…

curl "$GORUNNER/api/embed/v1/templates" \
  -H "Authorization: Bearer $GORUNNER_EMBED_KEY"

Response · 200 OK

json
{
  "data": [
    {
      "id": "9c4e2a17-3d5b-4f86-b0e2-8a1c7d3f5e29",
      "key": "orders-to-sheets",
      "name": "New orders to Sheets",
      "description": "Adds each new order as a row.",
      "category": "Sales",
      "triggerType": "webhook",
      "pieces": [
        "webhook",
        "googlesheets"
      ],
      "connections": [
        {
          "key": "c1",
          "pieceId": "googlesheets",
          "steps": [
            "add_row"
          ]
        }
      ]
    }
  ],
  "pagination": {
    "limit": 50,
    "nextCursor": null
  }
}
Every field

It takes no body.

Response · 200 OK

dataarray of objects
idUUID
keystring

The stable handle to install by.

namestring
descriptionstring
categorystring or null
triggerTypestring
piecesarray of strings

Every app its steps use.

connectionsarray of objects

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

keystring

The slot’s name in this template (c1, c2, … in the order the steps first use it).

pieceIdstring

The service a connection for this slot must be for.

stepsarray of strings

The steps that use it; trigger for the trigger.

paginationobject
limitinteger
nextCursorstring or null

The cursor of the next page; null on the last page. A page that comes back full can carry a cursor even when nothing follows: the next page is then empty, with null here. Keep going until it is null.