Get category definitions

Retrieve all available category definitions including display labels, icons, colors, and ordering. Categories determine how nodes are organized in the sidebar.

Built-in categories are always available as defaults. This endpoint allows overriding built-in category metadata and defining custom categories.

GET /categories

Get category definitions

cURL

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

200

{
  "success": true,
  "data": [
    {
      "name": "triggers",
      "label": "Triggers",
      "icon": "mdi:lightning-bolt",
      "color": "var(--fd-node-cyan)",
      "weight": 0
    },
    {
      "name": "inputs",
      "label": "Inputs",
      "icon": "mdi:arrow-down-circle",
      "color": "var(--fd-node-emerald)",
      "weight": 1
    },
    {
      "name": "ml",
      "label": "Machine Learning",
      "icon": "mdi:brain",
      "color": "var(--fd-node-purple)",
      "description": "Custom ML processing nodes",
      "weight": 20
    }
  ],
  "message": "Categories loaded successfully"
}

Authorizations

BearerAuthSessionAuth

Authorization · string · header · required

JWT token for authentication

Response

200

application/json

Categories 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)