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.
  • additionalProperties controls 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.

See also

Was this page helpful?