Skip to content

Flow file YAML schema reference

The following pages provide a comprehensive reference to the syntax used by the Qruise flow files. They’re not intended as an introduction to running and customising workflows. If you want to learn more about this, you can take a look at our Running a workflow guide.

The starting point for this reference is the flow object.

How to use this guide

Each page of this reference documents a data type that can be used in a flow file, with all the fields explained. For brevity, we use Python-type annotations from the typing module. If you’re already a Python user you’re most likely already familiar with these, but they’re close enough to human language that you should have no problems understanding them, even if you have never used Python before.

On each page you’ll find a YAML snippet for a data type, containing all the keys a particular object can have, with the values specifying the field type. For instance, the snippet for the flow object has the following form:

YAML
name: str
schedules: List[cronSchedule] | None
qubits: List[str]
couplings: List[Tuple[str, str]]
stages: stages
batch_groups: List[batchGroup] | None

As you can see, the field name must be a string, while qubits is an optional field and accepts a list of strings. You can use these snippets to create new flow files with minimal effort.