Get Node Detail

{
  "data": {
    "node_type": "source_script",
    "display_name": "Script Input",
    "description": "Upload or type your script",
    "version": 1,
    "category": "source",
    "inputs": [],
    "outputs": [
      {
        "name": "lines",
        "fields": [
          "locale_code",
          "script"
        ]
      }
    ],
    "config_schema": {
      "csv_column": {
        "anyOf": [
          {
            "maxLength": 200,
            "type": "string"
          },
          {
            "type": "null"
          }
        ]
      },
      "csv_has_header": {
        "default": true,
        "type": "boolean"
      },
      "input_mode": {
        "default": "plain",
        "enum": [
          "plain",
          "markup"
        ],
        "type": "string"
      },
      "input_type": {
        "enum": [
          "text",
          "file",
          "media"
        ],
        "type": "string"
      },
      "source_language": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ]
      },
      "text": {
        "default": "",
        "maxLength": 500000,
        "type": "string"
      },
      "upload_ids": {
        "items": {
          "format": "uuid",
          "type": "string"
        },
        "maxItems": 50,
        "type": "array"
      }
    },
    "options": {}
  },
  "meta": {
    "request_id": "01ABC...",
    "timestamp": "2026-04-09T00:00:00Z"
  }
}

Return full node definition and runtime configuration options for a node type.

Deprecated: use GET /api/v2/nodes/{node_type} instead. This v1 variant inlines the full TTS model catalog under options.models_by_provider, which creates a large response and couples clients to the catalog structure. The v2 endpoint replaces that inline tree with a providers HATEOAS href pointing to the standalone /api/v1/providers catalog, so the model list is fetched lazily only when needed.

Unlike GET /nodes (which returns only static port schemas), this endpoint returns the runtime values a caller uses to configure a node: supported target languages derived from deployment settings, the available model catalog, and a HATEOAS link to the workspace-scoped voice list. Requires X-Workspace-Id.

Return full node definition and runtime configuration options for a node type. **Deprecated:** use `GET /api/v2/nodes/{node_type}` instead. This v1 variant inlines the full TTS model catalog under `options.models_by_provider`, which creates a large response and couples clients to the catalog structure. The v2 endpoint replaces that inline tree with a `providers` HATEOAS href pointing to the standalone `/api/v1/providers` catalog, so the model list is fetched lazily only when needed. Unlike `GET /nodes` (which returns only static port schemas), this endpoint returns the runtime values a caller uses to configure a node: supported target languages derived from deployment settings, the available model catalog, and a HATEOAS link to the workspace-scoped voice list. Requires `X-Workspace-Id`.

Authentication

AuthorizationBearer

Clerk JWT token

Path parameters

node_typestringRequired

Response

Successful Response

dataobject

Full node definition + runtime options for the canvas node-config UI.

metaobject

Errors

404

Not Found Error

422

Unprocessable Entity Error

Return full node definition and runtime configuration options for a node type.

$	curl https://api.onepin.ai/api/v1/nodes/node_type \
>	-H "Authorization: Bearer <token>"

Authentication

Path parameters

Headers

Response

Errors