Validate a product template | Runtype Documentation

curl -X POST https://api.runtype.com/v1/public/products/validate-template \
     -H "Authorization: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "productObject": {
    "_meta": {
      "catalogVersion": "2026-06-01",
      "generatedAt": "2026-06-01T00:00:00.000Z",
      "generatorVersion": "1.0.0",
      "planHash": "abc123",
      "schemaVersion": "1.1"
    },
    "capabilities": [
      {
        "description": "Summarizes input text",
        "flow": {
          "description": "Summarizes the provided input",
          "name": "Summarizer",
          "steps": [
            {
              "config": {
                "model": "gpt-5-mini",
                "systemPrompt": "Summarize the following text.",
                "userPrompt": "{{input}}"
              },
              "name": "Summarize",
              "type": "prompt"
            }
          ]
        },
        "id": "summarize",
        "name": "Summarize"
      }
    ],
    "product": {
      "description": "A product template with variables",
      "name": "Template Product"
    },
    "surfaces": [],
    "tools": [],
    "version": "1.1"
  },
  "template": {
    "variables": [
      {
        "inputType": "textarea",
        "key": "input",
        "label": "Input Text",
        "required": true
      }
    ]
  },
  "version": "1.1"
}'

{
  "errors": [
    {
      "code": "string",
      "message": "string",
      "path": "string",
      "severity": "string"
    }
  ],
  "recommendations": [
    {
      "code": "string",
      "message": "string",
      "path": "string",
      "severity": "string"
    }
  ],
  "valid": true,
  "warnings": [
    {
      "code": "string",
      "message": "string",
      "path": "string",
      "severity": "string"
    }
  ]
}

Validates a product template against the platform schema.

Authentication

AuthorizationBearer

API key or Clerk session token

Request

This endpoint expects an object.

Response

Validation result

errorslist of objects

recommendationslist of objects

validboolean

warningslist of objects

Errors

400

Bad Request Error

500

Internal Server Error