Get Node Detail V2

{
  "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 (v2).

Extends GET /api/v1/nodes/{node_type} by replacing the large inline model catalog (options.models_by_provider) with a providers HATEOAS href pointing to GET /api/v1/providers. Clients follow that link to load the model list and each model’s configuration schema only when the user opens the relevant configuration panel, rather than receiving it in every node-detail response.

The voices HATEOAS href (with its provider, model, and language filter parameters) is unchanged from v1, so the voice picker does not require a catalog call. Supported target languages are resolved from deployment settings at request time. Requires X-Workspace-Id and the catalog:read scope.

Return full node definition and runtime configuration options for a node type (v2). Extends `GET /api/v1/nodes/{node_type}` by replacing the large inline model catalog (`options.models_by_provider`) with a `providers` HATEOAS href pointing to `GET /api/v1/providers`. Clients follow that link to load the model list and each model's configuration schema only when the user opens the relevant configuration panel, rather than receiving it in every node-detail response. The `voices` HATEOAS href (with its provider, model, and language filter parameters) is unchanged from v1, so the voice picker does not require a catalog call. Supported target languages are resolved from deployment settings at request time. Requires `X-Workspace-Id` and the `catalog:read` scope.

Authentication

AuthorizationBearer

Clerk JWT token

AuthorizationBearer

Onepin live API key (op_live_...). Test and public keys are reserved in Phase 1.

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 (v2).

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

Authentication

Path parameters

Headers

Response

Errors