---
title: "List node types"
method: GET
path: "/api/v1/node-types"
tags: ["Node Types"]
---

# List node types

`GET /api/v1/node-types`

## Request

- Base URL: `https://api.studio.kaitoi.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.studio.kaitoi.io/api/v1/node-types`
- Auth: HTTP bearer

Returns node types available to the authenticated user. Use this endpoint to discover compatible node identifiers before building automation against a graph.

## Query parameters

- `limit` integer, nullable: Maximum number of node types to return. Defaults to 50; capped at 200.
- `cursor` string, nullable: Opaque cursor returned from the previous page.
- `search` string, nullable: Smart search over node type, title, category, description, and tags using the shared node catalog ranking.
- `fields` string, nullable: Optional comma-separated response projection. `type` is always returned. Omit for the existing full summary response.

## Headers

- `authorization` string, nullable

## Response `200`

A page of node type summaries.

- PublicListResponsePublicNodeTypeSummary
  - `data` PublicNodeTypeSummary[], required: Items returned for this page.
    - `type` string, required: Node type identifier.
    - `title` string, required: Node display title.
    - `category` string, nullable: Node category.
    - `description` string, nullable: Short description of what the node does.
    - `icon` string, nullable: Icon identifier used by the UI.
    - `thumbnailUrl` string, nullable: Short-lived signed URL for the node catalog thumbnail, when available.
    - `thumbnailExpiresAt` string, date-time, nullable: Expiration timestamp for thumbnailUrl, when present.
    - `tags` string[]: Search and discovery tags.
    - `source` string, nullable: Source namespace for the node type.
  - `nextCursor` string, nullable: Opaque cursor for the next page. Omitted when there are no more results.
  - `hasMore` boolean, required: True when another page is available.

## Other responses

- `401`: Missing, malformed, expired, or revoked bearer token.
- `403`: The API key lacks the required scope or account capability.
- `422`: Validation Error
- `429`: The client or API key exceeded the REST API rate limit.
- `503`: The shared REST API rate limiter is temporarily unavailable.

---

[API](https://skmtc.dev/kaitoi/apis/kaitoi-rest-api.md) · [All operations](https://skmtc.dev/kaitoi/apis/kaitoi-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kaitoi/apis/kaitoi-rest-api/revisions/239a74aa2c64?raw)