---
title: "List node types"
method: GET
path: "/v1/agents/node-types"
tags: ["Agents"]
---

# List node types

`GET /v1/agents/node-types`

List the node types available for building agents.

The set is deterministic and does not depend on the caller, so the response
is safe to cache across sessions. Integration-dependent and dynamic-schema
node types are intentionally excluded in v1.

## Response `200`

Successful Response

- ListNodeTypesResponse — List of node types available to v1 agent authors.
  - `data` NodeTypeSummary[], required — Allowlisted node types, returned as thin summaries.
    - `node_type` string, required — Stable identifier for the node type, e.g. `llm`.
    - `display_name` string, required — Human-readable name for the node type.
    - `description` string, nullable — Short description of what the node type does, if provided.

## Other responses

- `422` — Validation Error

## Changes

- **2026-06-17** `56d428ca479f` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/cooper-square-technologies/apis/external-api/changes/v1/agents/node-types/get.md)

---

[API](https://skmtc.dev/cooper-square-technologies/apis/external-api.md) · [All operations](https://skmtc.dev/cooper-square-technologies/apis/external-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cooper-square-technologies/external-api/revisions/ab03b3c80494/schema)