Formations

Validate a formation template

Validates a formation template without creating any resources. Returns a list of errors and warnings. Accepts the template as a JSON object or as a YAML/JSON string.

post/v1/projects/{project_id}/formations/validate

Request

  • Base URL: https://api.naturali.ai
  • URL: https://api.naturali.ai/v1/projects/{project_id}/formations/validate
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.naturali.ai/authorize, token URL https://api.naturali.ai/token, scopes: mcp:access)

Request body

parametersobject nullable

Runtime parameter values that override or supply template parameter defaults. Keys must match parameter names declared in template.parameters. When provided, the validation result also reports required parameters that are still missing after applying these values.

Example request

{
  "template": {
    "metadata": {
      "author": "John",
      "revision": 2
    }
  }
}

Response

Validation result

validboolean

Changes

No recorded changes to this operation across all 1 revision of this API.