Validate a full product object (FPO)

curl -X POST https://api.runtype.com/v1/public/products/validate \
     -H "Authorization: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "_meta": {
    "catalogVersion": "2026-06-01",
    "generatedAt": "2026-06-01T00:00:00.000Z",
    "generatorVersion": "1.0.0",
    "planHash": "abc123",
    "schemaVersion": "2.0"
  },
  "capabilities": [
    {
      "agent": {
        "config": {
          "model": "claude-sonnet-4-5",
          "systemPrompt": "You are a helpful assistant."
        },
        "description": "Helpful assistant agent",
        "name": "Chat Agent"
      },
      "description": "Conversational chat capability",
      "id": "chat",
      "name": "Chat"
    }
  ],
  "product": {
    "description": "An AI-powered product",
    "name": "My AI Product"
  },
  "surfaces": [
    {
      "config": {},
      "id": "chat-widget",
      "name": "Chat Widget",
      "routes": [
        {
          "capabilityId": "chat"
        }
      ],
      "type": "chat"
    }
  ],
  "tools": [],
  "version": "2.0"
}'

{
  "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 Full Product Object (FPO) against the platform schema and returns errors, warnings, and recommendations.

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

403

Forbidden Error

500

Internal Server Error