For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Dashboard
User GuideDeveloper GuidesAPI Reference
User GuideDeveloper GuidesAPI Reference
    • Overview
  • Runtype API
      • POSTValidate a full product object (FPO)
      • POSTValidate a product template
      • POSTValidate a standalone agent definition
      • POSTValidate a standalone flow definition
      • POSTValidate a standalone surface definition
      • POSTValidate a standalone tool definition
Dashboard
LogoLogo
Runtype APIProduct Validation

Validate a full product object (FPO)

POST
/v1/public/products/validate
POST
/v1/public/products/validate
$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"
>}'
1{
2  "errors": [
3    {
4      "code": "string",
5      "message": "string",
6      "path": "string",
7      "severity": "string"
8    }
9  ],
10  "recommendations": [
11    {
12      "code": "string",
13      "message": "string",
14      "path": "string",
15      "severity": "string"
16    }
17  ],
18  "valid": true,
19  "warnings": [
20    {
21      "code": "string",
22      "message": "string",
23      "path": "string",
24      "severity": "string"
25    }
26  ]
27}

Validates a Full Product Object (FPO) against the platform schema and returns errors, warnings, and recommendations.

Was this page helpful?
Previous

Validate a product template

Next
Built with

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