---
title: "List all available workflow nodes"
method: GET
path: "/api/workflow/nodes"
tags: ["Workflows"]
---

# List all available workflow nodes

`GET /api/workflow/nodes`

## Request

- Base URL: `https://app.herondata.io`
- URL: `https://app.herondata.io/api/workflow/nodes`
- Auth: API key in header `x-api-key`

Get metadata for all nodes that can be used in JSONWorkflows. Requires workflow_heron_id to get user-specific schemas.

## Query parameters

- `workflow_heron_id` string, required

## Response `200`

List of available nodes with their metadata

- NodeMetadataSchema[]
  - `beta` boolean, required
  - `cache_policy` CachePolicyDefinition, required
    - `enabled` boolean, required
    - `scope` string, required
    - `ttl_seconds` integer, required
  - `category` string, required
  - `deprecation_warning` string, nullable
  - `description` string, required
  - `input_field_order` string[], required
  - `input_handles` Handle[], required
    - `identifier` string, required
    - `name` string, required
  - `input_schema` object, required
  - `is_silent_run_safe` boolean, required
  - `latest_version` integer, required
  - `local_variables` LocalVariable[], required
    - `description` string, required
    - `json_schema` object, required
    - `name` string, required
  - `output_handles` Handle[], required
    - `identifier` string, required
    - `name` string, required
  - `output_schema` object, required
  - `subcategory` string, nullable
  - `type` string, required
  - `use_static_id` boolean, required
  - `version` integer, required

## Other responses

- `400`: Missing workflow_heron_id parameter
- `404`: Workflow not found

## Changes

- **2026-11-03** `bd8008e49534`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/herondata/apis/heron-data-api/changes/api/workflow/nodes/get.md)

---

[API](https://skmtc.dev/herondata/apis/heron-data-api.md) - [All operations](https://skmtc.dev/herondata/apis/heron-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/herondata/apis/heron-data-api/revisions/1ec936e17fef?raw)