Templates are published workflows from the community library. This endpoint lets agents and integrations browse the catalog token-efficiently: you get the metadata and the input interface, never the workflow graph itself (nodes, edges, and node configuration stay private to the creator).

List Templates

GET /api/v1/templates

Returns published templates. Requires authentication with the workflows:read scope (implied by workflows:execute and workflows:write).

The catalog is cached server-side for up to 60 seconds, so a just-published template can take a minute to appear. Catalogs beyond 500 templates are truncated to the 500 most recently updated.

Query Parameters

Parameter	Type	Description
q	string	Case-insensitive search over title and description
tag	string	Filter by category tag (e.g. video, anime)
sort	string	recent (default, most recently updated) or popular (most viewed)
limit	number	Page size. Default 20, max 50
offset	number	Number of results to skip. Default 0

Request

curl "https://www.wireflow.ai/api/v1/templates?tag=video&sort=popular&limit=10" \
  -H "Authorization: Bearer sk-your-api-key"

Response 200 OK

{
  "data": [
    {
      "id": "cm1abc123",
      "publishedSlug": "anime-reel-factory",
      "title": "Anime Reel Factory",
      "description": "Turns a prompt into a 3-act anime reel",
      "tags": ["video", "anime"],
      "coverImage": "https://cdn.wireflow.ai/poster.jpg",
      "exampleOutputs": [
        {
          "label": "Final reel",
          "type": "video",
          "url": "https://cdn.wireflow.ai/renders/reel-final.mp4"
        }
      ],
      "views": 420,
      "likeCount": 12,
      "duplicates": 33,
      "updatedAt": "2026-07-01T00:00:00.000Z",
      "author": {
        "displayName": "Michael",
        "handle": "michael",
        "avatarUrl": "https://cdn.wireflow.ai/a.png"
      },
      "inputInterface": [
        {
          "nodeId": "node-prompt",
          "nodeType": "input:text",
          "label": "Story prompt",
          "inputType": "text"
        }
      ]
    }
  ],
  "pagination": { "total": 1, "limit": 10, "offset": 0, "hasMore": false }
}

Fields

• tags — the template's category tags (the internal template marker tag is stripped).
• exampleOutputs — sample media the template has produced, resolved server-side to { label, type, url } entries (type is image, video, or audio). Empty array when no examples are available.
• inputInterface — the template's user-facing inputs, projected from the graph's input nodes. Only the node id, node type, label, and expected input kind (text, image, url, …) are exposed.
• author — the creator's public profile fields only (same as community pages).

What is never returned

The workflow graph is the creator's IP. The response never includes nodes, edges, node config/params/prompt values, secrets, or the author's email. Discovery is read-only: to use a template, duplicate it from its public page in the app, or run it directly with Execute Templates if the author has enabled API execution.