Get all available node types

Retrieve all available node processors with optional filtering by category, search query, and pagination. Supports filtering by node category (models, data_processing, input_output, etc.) and search queries.

GET /nodes

Get all available node types

cURL

curl --request GET \
  --url http://localhost:5173/api/flowdrop/nodes \
  --header 'Authorization: Bearer <token>'

200

{
  "success": true,
  "data": [
    {
      "id": "openai_chat_executor",
      "name": "OpenAI Chat",
      "description": "Chat completion using OpenAI's GPT models",
      "category": "ai",
      "version": "1.0.0",
      "icon": "mdi:chat",
      "color": "#10a37f",
      "type": "default",
      "supportedTypes": [
        "default",
        "simple"
      ],
      "inputs": [
        {
          "id": "data",
          "name": "Input Data",
          "type": "input",
          "dataType": "mixed",
          "required": false,
          "description": "Input data for the node"
        }
      ],
      "outputs": [
        {
          "id": "response",
          "name": "Response",
          "type": "output",
          "dataType": "string",
          "description": "The OpenAI response"
        }
      ],
      "configSchema": {
        "type": "object",
        "properties": {
          "model": {
            "type": "string",
            "title": "Model",
            "default": "gpt-4o-mini",
            "enum": [
              "gpt-4o-mini",
              "gpt-5",
              "gpt-4.1"
            ]
          },
          "temperature": {
            "type": "number",
            "title": "Temperature",
            "default": 0.7,
            "minimum": 0,
            "maximum": 2
          },
          "maxTokens": {
            "type": "integer",
            "title": "Max Tokens",
            "default": 1000,
            "minimum": 1,
            "maximum": 4096
          },
          "apiKey": {
            "type": "string",
            "title": "API Key",
            "format": "hidden"
          }
        }
      },
      "tags": [
        "openai",
        "gpt",
        "chat",
        "ai"
      ]
    }
  ],
  "message": "Found 1 node types"
}

Authorizations

BearerAuthSessionAuth

Authorization · string · header · required

JWT token for authentication

Query Parameters

category · string

Filter by node category Node category for organizing nodes in the sidebar.

Any string value is accepted, allowing custom categories. Custom categories can be defined via the /categories endpoint with display labels, icons, and colors.

Built-in categories with dedicated icons and colors: triggers, inputs, outputs, prompts, models, processing, logic, data, tools, helpers, vector stores, embeddings, memories, agents, ai, interrupts, bundles

Example:

"processing"

search · string

Search node types by name, description, or tags

Maximum string length: 100

limit · integer · default: 100

Maximum number of results (1-1000)

Required range: 1 <= x <= 1000

offset · integer · default: 0

Number of results to skip for pagination

Required range: x >= 0

Response

200

application/json

List of node types retrieved successfully

success · boolean

Whether the request was successful

data · object[]

Response data (type varies by endpoint)

Show child attributes

message · string

Response message

error · string

Error message (if any)