Skip to main content
Use JSON Schema when you want a workflow step to define a structured output shape that later steps can reference field by field.

​
Configuration

In Schema Items, click Add Item to add another field. Each row lets you define the output key and the value that key should hold. The Value field supports Insert Variable. The value is copied as written, so type the exact text you want or insert a variable. This step does not use a model to write or fill in values. If a value resolves to a JSON array or object, Fetch Hive stores it as structured JSON rather than a string. For example, a value of {{step_2.output.items}} can produce an array that an Iteration step can use later. You can also build a JSON array literal from multiple array variables, such as [{{step_2.output.items}},{{step_3.output.items}}]; this creates an array of arrays, not a flattened concatenation. When a value is exactly one variable, it keeps its original type: objects and arrays stay structured, and numbers and true/false values stay numbers and true/false. If the variable is empty or does not exist, the field is saved as null, not as empty text. Text typed directly, such as 1.0.0, stays text, and a value that mixes text with variables, such as Score: {{step_2.output.score}}, is saved as text.

​
Output

Click Run in the step header to test the step. Fetch Hive shows the generated result in Output after the run completes. Use the variable picker in a later step to insert the exact output path for your run. The base reference is:
If you want the full structured result, reference the base output directly:
If your run returns nested keys, the variable picker shows the exact fields you can insert into later steps.

​
Example

Add JSON Schema from the Utilities group in Search steps…. Set Name to something like Article fields. In Schema Items, add keys such as title, summary, and sentiment. For each item, type the value in Value. If a field should depend on earlier workflow data, click Insert Variable and add that reference. Click Run and review the structured result in Output before using those keys in later steps.

​
Notes

  • The settings sheet lets you add and remove schema rows with Add Item and the delete action on each row.
  • This step editor does not show a When the step fails control in its settings sheet.
  • JSON Schema preserves resolved JSON arrays and objects for downstream steps, including Iteration. It does not currently merge two arrays into one flat array automatically.
  • Use the variable picker after a test run if you want to confirm the exact keys available to later steps.
See also: Creating and Editing, Testing and Iteration, and AI Prompt