Validation

Definition YAML validation without storage

1 endpoint

Validate definition YAML

Validate a definition YAML without storing it. Useful for pre-submission validation. Runs the full validation pipeline: 1. YAML size check (150KB limit) 2. UTF-8 encoding validation 3. JSON Schema validation (ADL/CDL/WDL) 4. Semantic validation (business rules) Note: Reference validation is not performed during this endpoint. References are validated during the publish flow which has database access.

Requires authentication

Parameters

typerequiredstringpath

Definition type

agentcommandworkflowpipeline

Request Body

yamlrequiredstring

YAML content to validate

Responses

200Validation result (may contain errors/warnings even on 200)

400Invalid request parameters

401Authentication required

Response fields

dataobject

POST/api/v1/validate/{type}

curl -X POST "https://api.uluops.ai/api/v1/validate/agent" \
  -H "Authorization: Bearer $ULUOPS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "yaml": "name: example-agent\nversion: 1.0.0"
  }'

Response

{
  "data": {
    "valid": true,
    "errors": [
    {
      "code": "...",
      "message": "...",
      "path": "...",
      "line": 0,
      "column": 0,
      "severity": "error",
      "suggestion": "..."
    }
  ],
    "warnings": [
    {
      "code": "...",
      "message": "...",
      "path": "...",
      "line": 0,
      "column": 0,
      "severity": "error",
      "suggestion": "..."
    }
  ],
    "schemaVersion": "...",
    "validatedAt": "2026-01-15T10:30:00Z"
  }
}