Validate Schema | RoboSystems API

Validates a custom schema definition before deployment — checks structure, types, constraints, and relationship references. Returns errors and warnings without applying changes. Supports JSON, YAML, and dict formats.

Request body

Required, application/json.

Field Type Description

Field	Type	Description
`schema_definition`required	object \| string	Schema definition as JSON dict or JSON/YAML string
`format`optional	string	Schema format: json, yaml, or dict Default: `json`
`check_compatibility`optional	string[]	List of existing schema extensions to check compatibility with

schema_definitionrequired

object | string

Schema definition as JSON dict or JSON/YAML string

formatoptional

string

Schema format: json, yaml, or dict

Default: json

check_compatibilityoptional

string[]

List of existing schema extensions to check compatibility with

Example request

curl

curl -X POST "https://api.robosystems.ai/v1/graphs/schema/validate" \
  -H "X-API-Key: $ROBOSYSTEMS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "schema_definition": {
    "description": "Schema for financial data with companies and filings",
    "name": "financial_analysis",
    "nodes": [
      {
        "name": "Company",
        "properties": [
          {
            "name": "cik",
            "type": "STRING",
            "is_primary_key": true
          },
          {
            "name": "name",
            "type": "STRING",
            "is_required": true
          },
          {
            "name": "ticker",
            "type": "STRING"
          },
          {
            "name": "market_cap",
            "type": "INT64"
          }
        ]
      },
      {
        "name": "Filing",
        "properties": [
          {
            "name": "accession_number",
            "type": "STRING",
            "is_primary_key": true
          },
          {
            "name": "form_type",
            "type": "STRING",
            "is_required": true
          },
          {
            "name": "filing_date",
            "type": "DATE"
          }
        ]
      }
    ],
    "relationships": [
      {
        "from_node": "Company",
        "name": "FILED",
        "properties": [
          {
            "name": "filing_count",
            "type": "INT32"
          }
        ],
        "to_node": "Filing"
      }
    ],
    "version": "1.0.0"
  }
}'

Responses

200 Successful Response

Field	Type	Description
`valid`required	boolean	Whether the schema is valid
`message`required	string	Validation message
`errors`optional	string[]	List of validation errors (only present when valid=false)
`warnings`optional	string[]	List of validation warnings (schema is still valid but has potential issues)
`stats`optional	object	Schema statistics (only present when valid=true)
`compatibility`optional	object	Compatibility check results (only when check_compatibility specified)

Status	Meaning
400	Invalid request
401	Authentication required
403	Access denied
404	Resource not found
422	Schema fails validation rules
429	Rate limit exceeded
500	Internal server error
504	Validation timed out

Authentication

Request body

Example request

Responses