Validate JSON Output from a Jinba Flow Workflow

Use OUTPUT_JSON_WITH_VALIDATION to check a JSON string against a schema before returning it from a flow.

Use OUTPUT_JSON_WITH_VALIDATION when a workflow must return a JSON object with a known shape. The required value is a JSON string. The optional schema configuration is a JSON Schema string that checks the parsed object before it is returned in result.

Check the output shape

- id: customer_output
  tool: OUTPUT_JSON_WITH_VALIDATION
  config:
    - name: schema
      value: '{"type":"object","properties":{"name":{"type":"string"},"age":{"type":"number"}},"required":["name","age"]}'
  input:
    - name: value
      value: '{"name":"Ada","age":30}'

The example returns the parsed object in result. If the JSON is malformed or does not match the schema, the step fails with an Invalid JSON error whose details list the problems, and result is null. Without schema, the tool parses the JSON but does not apply those field requirements.

For validating JSON supplied to a published workflow, use Input JSON with Validation.