Required vs. Optional Fields
JSON Schema uses required arrays to mark fields that must be present.
What this means in practice
- If a field is in
required, missing it will fail validation. - Optional fields can be omitted without error.
additionalPropertiescontrols whether extra keys are allowed.
At the HTTP layer, organizationId and variables are required for POST /api/skills/:id/run, while the inner variable requirements are controlled by the skill schema.