Appearance
composition.validate ​
Validate a composition definition against the live registry (no persist)
Validate a composition definition against the live registry without saving.
Overview ​
| Property | Value |
|---|---|
| Workflow type | Atomic |
| Library | App-composition |
| Version | 1.0 |
Input Schema ​
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
organization_uuid | uuid | Yes | — | — |
definition | dict | Yes | — | Serializer-dialect VirtualWorkflow: top-level name plus layers; each layer has name and steps; each step has name, workflow_type, and optional input_mapping param -> {source: input |
include_dry_run | boolean | No | False | Also run the pre-activation dry-run data-flow gate |
summary_only | boolean | No | False | Return the verdict only — passed, errors, warnings and repairs_total — with an empty repairs array. For callers that want to know whether a definition is valid without transporting the repair candidates. |
Output Schema ​
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
passed | boolean | Yes | — | — |
errors | list | Yes | — | — |
warnings | list | Yes | — | — |
repairs | list | Yes | — | Machine-actionable RepairSuggestions for ambiguous/missing inputs. Bounded: read repairs_total for the full count and each repair's candidates_total for its own |
repairs_total | integer | Yes | — | How many repairs the validator produced, before bounding |
dry_run | dict | No | — | {passed, errors, evaluated} when include_dry_run was set |
failure_reason | string | No | — | Engine-stamped human-readable failure reason |
failure_type | string | No | — | Engine-stamped failure category |
failed_action | string | No | — | Engine-stamped action method that raised |
failed_at_state | string | No | — | Engine-stamped state when the workflow failed |
failed_step | string | No | — | Engine-stamped DAG step that failed |
failed_layer | string | No | — | Engine-stamped DAG layer that failed |
error | string | No | — | Engine-stamped exception message |
error_type | string | No | — | Engine-stamped exception class name |
States ​
| State | Initial | Terminal | Success | Auto-advance | Description |
|---|---|---|---|---|---|
done | Yes | Yes | Yes | — | — |
API Usage ​
bash
POST /api/workflows/start
Content-Type: application/json
{
"workflow_type": "composition.validate",
"initial_data": {
"organization_uuid": "value",
"definition": "value"
}
}