{
  "title": "JSON schema for Buildkite pipeline configuration files",
  "$schema": "http://json-schema.org/draft-06/schema",
  "fileMatch": [
    "buildkite.yml",
    "buildkite.yaml",
    "buildkite.json",
    "buildkite.*.yml",
    "buildkite.*.yaml",
    "buildkite.*.json",
    ".buildkite/pipeline.yml",
    ".buildkite/pipeline.yaml",
    ".buildkite/pipeline.json",
    ".buildkite/pipeline.*.yml",
    ".buildkite/pipeline.*.yaml",
    ".buildkite/pipeline.*.json"
  ],
  "definitions": {
    "commonOptions": {
      "allowDependencyFailure": {
        "type": "boolean",
        "description": "Whether to proceed with this step and further steps if a step named in the depends_on attribute fails",
        "default": false
      },
      "agents": {
        "oneOf": [
          { "$ref": "#/definitions/commonOptions/agentsObject" },
          { "$ref": "#/definitions/commonOptions/agentsList" }
        ]
      },
      "agentsObject": {
        "type": "object",
        "description": "Query rules to target specific agents",
        "examples": [
          { "queue": "deploy" },
          { "ruby": "2*" }
        ]
      },
      "agentsList": {
        "type": "array",
        "description": "Query rules to target specific agents in k=v format",
        "examples": [
          "queue=default",
          "xcode=true"
        ],
        "items": {
          "type": "string"
        }
      },
      "automaticRetry": {
        "type": "object",
        "properties": {
          "exit_status": {
            "description": "The exit status number that will cause this job to retry",
            "anyOf": [
              {
                "type": "string",
                "enum": [ "*" ]
              },
              {
                "type": "number"
              }
            ]
          },
          "limit": {
            "type": "integer",
            "description": "The number of times this job can be retried",
            "minimum": 1,
            "maximum": 10
          },
          "signal": {
            "description": "The exit signal, if any, that may be retried",
            "type": "string",
            "examples": [
              "*",
              "none",
              "SIGKILL",
              "term"
            ]
          },
          "signal_reason": {
            "description": "The exit signal reason, if any, that may be retried",
            "type": "string",
            "enum": [
              "*",
              "none",
              "agent_refused",
              "agent_stop",
              "cancel",
              "process_run_error"
            ]
          }
        },
        "additionalProperties": false
      },
      "branches": {
        "description": "Which branches will include this step in their builds",
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "array",
            "items": { "type": "string" }
          }
        ],
        "examples": [
          "master",
          [ "feature/*", "chore/*" ]
        ]
      },
      "cancelOnBuildFailing": {
        "type": "boolean",
        "description": "Whether to cancel the job as soon as the build is marked as failing",
        "default": false
      },
      "dependsOn": {
        "description": "The step keys for a step to depend on",
        "anyOf": [
          {"type": "null"},          
          {"type": "string"},
          {
            "type": "array",
            "items": {
              "anyOf": [
                {"type": "string"},
                {
                  "type": "object",
                  "properties": {
                    "step": { "type": "string" },
                    "allow_failure": {
                      "type": "boolean",
                      "default": false
                    }
                  },
                  "additionalProperties": false
                }
              ]
            }
          }
        ]
      },
      "env": {
        "type": "object",
        "description": "Environment variables for this step",
        "examples": [
          { "NODE_ENV": "test" }
        ]
      },
      "identifier": {
        "type": "string",
        "description": "A string identifier",
        "examples": [ "an-id" ]
      },
      "if": {
        "type": "string",
        "description": "A boolean expression that omits the step when false",
        "examples": [ "build.message != 'skip me'", "build.branch == 'master'" ]
      },
      "key": {
        "type": "string",
        "description": "A unique identifier for a step, must not resemble a UUID",
        "examples": [ "deploy-staging", "test-integration" ]
      },
      "label": {
        "type": "string",
        "description": "The label that will be displayed in the pipeline visualisation in Buildkite. Supports emoji.",
        "examples": [ ":docker: Build" ]
      },
      "buildNotify": {
        "type": "array",
        "description": "Array of notification options for this step",
        "items": {
          "oneOf": [
            {
              "type": "string",
              "enum": ["github_check", "github_commit_status"]
            },
            {
              "type": "object",
              "properties": {
                "email": {
                  "type": "string"
                },
                "if": {
                  "$ref": "#/definitions/commonOptions/if"
                }
              },
              "additionalProperties": false
            },
            {
              "type": "object",
              "properties": {
                "basecamp_campfire": {
                  "type": "string"
                },
                "if": {
                  "$ref": "#/definitions/commonOptions/if"
                }
              },
              "additionalProperties": false
            },
            {
              "type": "object",
              "properties": {
                "slack": {
                  "oneOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "channels": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "message": {
                          "type": "string"
                        }
                      }
                    }
                  ]
                },
                "if": {
                  "$ref": "#/definitions/commonOptions/if"
                }
              },
              "additionalProperties": false
            },
            {
              "type": "object",
              "properties": {
                "webhook": {
                  "type": "string"
                },
                "if": {
                  "$ref": "#/definitions/commonOptions/if"
                }
              },
              "additionalProperties": false
            },
            {
              "type": "object",
              "properties": {
                "pagerduty_change_event": {
                  "type": "string"
                },
                "if": {
                  "$ref": "#/definitions/commonOptions/if"
                }
              },
              "additionalProperties": false
            },
            {
              "type": "object",
              "properties": {
                "github_commit_status": {
                  "type": "object",
                  "properties": {
                    "context": {
                      "description": "GitHub commit status name",
                      "type": "string"
                    }
                  }
                },
                "if": {
                  "$ref": "#/definitions/commonOptions/if"
                }
              },
              "additionalProperties": false
            },
            {
              "type": "object",
              "properties": {
                "github_check": {
                  "type": "object",
                  "properties": {
                    "context": {
                      "description": "GitHub commit status name",
                      "type": "string"
                    }
                  }
                },
                "if": {
                  "$ref": "#/definitions/commonOptions/if"
                }
              },
              "additionalProperties": false
            }
          ]
        }
      },
      "fields": {
        "type": "array",
        "description": "A list of input fields required to be filled out before unblocking the step",
        "items": {
          "oneOf": [
            {
              "type": "object",
              "properties": {
                "text": {
                  "type": "string",
                  "description": "The text input name",
                  "examples": [
                    "Release Name"
                  ]
                },
                "key": {
                  "type": "string",
                  "description": "The meta-data key that stores the field's input",
                  "pattern": "^[a-zA-Z0-9-_]+$",
                  "examples": [
                    "release-name"
                  ]
                },
                "hint": {
                  "type": "string",
                  "description": "The explanatory text that is shown after the label",
                  "examples": [
                    "What’s the code name for this release? :name_badge:"
                  ]
                },
                "required": {
                  "type": "boolean",
                  "default": true,
                  "description": "Whether the field is required for form submission"
                },
                "default": {
                  "type": "string",
                  "description": "The value that is pre-filled in the text field",
                  "examples": [
                    "Flying Dolphin"
                  ]
                }
              },
              "additionalProperties": false,
              "required": [
                "key"
              ]
            },
            {
              "type": "object",
              "properties": {
                "select": {
                  "type": "string",
                  "description": "The text input name",
                  "examples": [
                    "Release Stream"
                  ]
                },
                "key": {
                  "type": "string",
                  "description": "The meta-data key that stores the field's input",
                  "pattern": "^[a-zA-Z0-9-_]+$",
                  "examples": [
                    "release-stream"
                  ]
                },
                "default": {
                  "oneOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "array",
                      "items": { "type": "string" }
                    }
                  ],
                  "description": "The value of the option(s) that will be pre-selected in the dropdown",
                  "examples": [ "beta" , [ "alpha" , "beta" ] ]
                },
                "hint": {
                  "type": "string",
                  "description": "The explanatory text that is shown after the label",
                  "examples": [
                    "What’s the code name for this release? :name_badge:"
                  ]
                },
                "multiple": {
                  "type": "boolean",
                  "description": "Whether more than one option may be selected",
                  "default": false
                  },
                "options": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "label": {
                        "type": "string",
                        "description": "The text displayed on the select list item",
                        "examples": [ "Stable" ]
                      },
                      "value": {
                        "type": "string",
                        "description": "The value to be stored as meta-data",
                        "examples": [ "stable" ]
                      },
                      "hint": {
                        "type": "string",
                        "description": "The text displayed directly under the select field’s label",
                        "examples": [
                          "Which release stream does this belong in? :fork:"
                        ]
                      },
                      "required": {
                        "type": "boolean",
                        "default": true,
                        "description": "Whether the field is required for form submission"
                      }
                    },
                    "additionalProperties": false,
                    "required": [
                      "label",
                      "value"
                    ]
                  }
                },
                "required": {
                  "type": "boolean",
                  "default": true,
                  "description": "Whether the field is required for form submission"
                }
              },
              "additionalProperties": false,
              "required": [
                "key",
                "options"
              ]
            }
          ]
        }
      },
      "matrixElement": {
        "oneOf": [
          {"type": "string"},
          {"type": "integer"},
          {"type": "boolean"}
        ]
      },
      "prompt": {
        "type": "string",
        "description": "The instructional message displayed in the dialog box when the unblock step is activated",
        "examples": [
          "Release to production?"
        ]
      },
      "skip": {
        "anyOf": [
          { "type": "boolean" },
          { "type": "string" }
        ],
        "description": "Whether this step should be skipped. You can specify a reason for using a string.",
        "examples": [
          true,
          false,
          "My reason"
        ]
      },
      "softFail": {
        "description": "The conditions for marking the step as a soft-fail.",
        "anyOf": [
          {
            "type": "boolean"
          },
          {
            "type": "array",
            "items": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "exit_status": {
                      "description": "The exit status number that will cause this job to soft-fail",
                      "anyOf": [
                        {
                          "type": "string",
                          "enum": [ "*" ]
                        },
                        {
                          "type": "number"
                        }
                      ]
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "blockStep": {
      "type": "object",
      "properties": {
        "allow_dependency_failure": {
          "$ref": "#/definitions/commonOptions/allowDependencyFailure"
        },
        "block": {
          "type": "string",
          "description": "The label of the block step"
        },
        "blocked_state": {
          "type": "string",
          "description": "The state that the build is set to when the build is blocked by this block step",
          "enum": [ "passed", "failed", "running" ]
        },
        "branches": {
          "$ref": "#/definitions/commonOptions/branches"
        },
        "depends_on": {
          "$ref": "#/definitions/commonOptions/dependsOn"
        },
        "fields": {
          "$ref": "#/definitions/commonOptions/fields"
        },
        "id": {
          "$ref": "#/definitions/commonOptions/identifier"
        },
        "identifier": {
          "$ref": "#/definitions/commonOptions/identifier"
        },
        "if": {
          "$ref": "#/definitions/commonOptions/if"
        },
        "key": {
          "$ref": "#/definitions/commonOptions/key"
        },
        "label": {
          "$ref": "#/definitions/commonOptions/label"
        },
        "name": {
          "$ref": "#/definitions/commonOptions/label"
        },
        "prompt": {
          "$ref": "#/definitions/commonOptions/prompt"
        },
        "type": {
          "type": "string",
          "enum": [ "block" ]
        }
      },
      "additionalProperties": false
    },
    "nestedBlockStep": {
      "type": "object",
      "properties": {
        "block": {
          "$ref": "#/definitions/blockStep"
        }
      },
      "additionalProperties": false
    },
    "stringBlockStep": {
      "type": "string",
      "description": "Pauses the execution of a build and waits on a user to unblock it",
      "enum": [ "block" ]
    },
    "inputStep": {
      "type": "object",
      "properties": {
        "allow_dependency_failure": {
          "$ref": "#/definitions/commonOptions/allowDependencyFailure"
        },
        "input": {
          "type": "string",
          "description": "The label of the input step"
        },
        "branches": {
          "$ref": "#/definitions/commonOptions/branches"
        },
        "depends_on": {
          "$ref": "#/definitions/commonOptions/dependsOn"
        },
        "fields": {
          "$ref": "#/definitions/commonOptions/fields"
        },
        "id": {
          "$ref": "#/definitions/commonOptions/identifier"
        },
        "identifier": {
          "$ref": "#/definitions/commonOptions/identifier"
        },
        "if": {
          "$ref": "#/definitions/commonOptions/if"
        },
        "key": {
          "$ref": "#/definitions/commonOptions/key"
        },
        "label": {
          "$ref": "#/definitions/commonOptions/label"
        },
        "name": {
          "$ref": "#/definitions/commonOptions/label"
        },
        "prompt": {
          "$ref": "#/definitions/commonOptions/prompt"
        },
        "type": {
          "type": "string",
          "enum": [ "input" ]
        }
      },
      "additionalProperties": false
    },
    "nestedInputStep": {
      "type": "object",
      "properties": {
        "input": {
          "$ref": "#/definitions/inputStep"
        }
      },
      "additionalProperties": false
    },
    "stringInputStep": {
      "type": "string",
      "description": "Pauses the execution of a build and waits on a user to unblock it",
      "enum": [ "input" ]
    },
    "commandStep": {
      "type": "object",
      "properties": {
        "agents": {
          "$ref": "#/definitions/commonOptions/agents"
        },
        "allow_dependency_failure": {
          "$ref": "#/definitions/commonOptions/allowDependencyFailure"
        },
        "artifact_paths": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "array",
              "items": { "type": "string" }
            }
          ],
          "description": "The glob path/s of artifacts to upload once this step has finished running",
          "examples": [
            [ "screenshots/*" ],
            [ "dist/myapp.zip", "dist/myapp.tgz" ]
          ]
        },
        "branches": {
          "$ref": "#/definitions/commonOptions/branches"
        },
        "cancel_on_build_failing": {
          "$ref": "#/definitions/commonOptions/cancelOnBuildFailing"
        },
        "command": {
          "description": "The commands to run on the agent",
          "anyOf": [
            { "type": "array", "items": { "type": "string" } },
            { "type": "string" }
          ]
        },
        "commands": {
          "description": "The commands to run on the agent",
          "$ref": "#/definitions/commandStep/properties/command"
        },
        "concurrency": {
          "type": "integer",
          "description": "The maximum number of jobs created from this step that are allowed to run at the same time. If you use this attribute, you must also define concurrency_group.",
          "examples": [
            1
          ]
        },
        "concurrency_group": {
          "type": "string",
          "description": "A unique name for the concurrency group that you are creating with the concurrency attribute",
          "examples": [
            "my-pipeline/deploy"
          ]
        },
        "concurrency_method": {
          "type": "string",
          "enum": ["ordered", "eager"],
          "description": "Control command order, allowed values are 'ordered' (default) and 'eager'.  If you use this attribute, you must also define concurrency_group and concurrency.",
          "examples": [
            "ordered"
          ]
        },
        "depends_on": {
          "$ref": "#/definitions/commonOptions/dependsOn"
        },
        "env": {
          "$ref": "#/definitions/commonOptions/env"
        },
        "id": {
          "$ref": "#/definitions/commonOptions/identifier"
        },
        "identifier": {
          "$ref": "#/definitions/commonOptions/identifier"
        },
        "if": {
          "$ref": "#/definitions/commonOptions/if"
        },
        "key": {
          "$ref": "#/definitions/commonOptions/key"
        },
        "label": {
          "$ref": "#/definitions/commonOptions/label"
        },
        "matrix": {
          "oneOf": [
            {
              "type": "array",
              "description": "List of elements for simple single-dimension Build Matrix",
              "items": { "$ref": "#/definitions/commonOptions/matrixElement" },
              "examples": [
                ["linux", "freebsd"]
              ]
            },
            {
              "type": "object",
              "description": "Configuration for multi-dimension Build Matrix",
              "properties": {
                "setup": {
                  "oneOf": [
                    {
                      "type": "array",
                      "description": "List of elements for single-dimension Build Matrix",
                      "items": { "$ref": "#/definitions/commonOptions/matrixElement" },
                      "examples": [
                        ["linux", "freebsd"]
                      ]
                    },
                    {
                      "type": "object",
                      "description": "Mapping of Build Matrix dimension names to their lists of elements",
                      "propertyNames": {
                        "type": "string",
                        "description": "Build Matrix dimension name",
                        "pattern": "^[a-zA-Z0-9_]+$"
                      },
                      "additionalProperties": {
                        "type": "array",
                        "description": "List of elements for this Build Matrix dimension",
                        "items": { "$ref": "#/definitions/commonOptions/matrixElement" }
                      },
                      "examples": [
                        {
                          "os": ["linux", "freebsd"],
                          "arch": ["arm64", "riscv"]
                        }
                      ]
                    }
                  ]
                },
                "adjustments": {
                  "type": "array",
                  "description": "List of Build Matrix adjustments",
                  "items": {
                    "type": "object",
                    "description": "An adjustment to a Build Matrix",
                    "properties": {
                      "with": {
                        "oneOf": [
                          {
                            "type": "array",
                            "description": "List of existing or new elements for single-dimension Build Matrix",
                            "items": { "$ref": "#/definitions/commonOptions/matrixElement" }
                          },
                          {
                            "type": "object",
                            "description": "Specification of a new or existing Build Matrix combination",
                            "propertyNames": {
                              "type": "string",
                              "description": "Build Matrix dimension name"
                            },
                            "additionalProperties": {
                              "type": "string",
                              "description": "Build Matrix dimension element"
                            },
                            "examples": [
                              { "os": "linux", "arch": "arm64" }
                            ]
                          }
                        ]
                      },
                      "skip": {
                        "$ref": "#/definitions/commonOptions/skip"
                      },
                      "soft_fail": {
                        "$ref": "#/definitions/commonOptions/softFail"
                      }
                    },
                    "required": ["with"]
                  }
                }
              },
              "required": ["setup"]
            }
          ]
        },
        "name": {
          "$ref": "#/definitions/commonOptions/label"
        },
        "notify": {
          "type": "array",
          "description": "Array of notification options for this step",
          "items": {
            "oneOf": [
              {
                "type": "string",
                "enum": ["github_check", "github_commit_status"]
              },
              {
                "type": "object",
                "properties": {
                  "basecamp_campfire": {
                    "type": "string"
                  },
                  "if": {
                    "$ref": "#/definitions/commonOptions/if"
                  }
                },
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "slack": {
                    "oneOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "object",
                        "properties": {
                          "channels": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "message": {
                            "type": "string"
                          }
                        }
                      }
                    ]
                  },
                  "if": {
                    "$ref": "#/definitions/commonOptions/if"
                  }
                },
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "github_commit_status": {
                    "type": "object",
                    "properties": {
                      "context": {
                        "description": "GitHub commit status name",
                        "type": "string"
                      }
                    }
                  },
                  "if": {
                    "$ref": "#/definitions/commonOptions/if"
                  }
                },
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "github_check": {
                    "type": "object",
                    "properties": {
                      "context": {
                        "description": "GitHub commit status name",
                        "type": "string"
                      }
                    }
                  },
                  "if": {
                    "$ref": "#/definitions/commonOptions/if"
                  }
                },
                "additionalProperties": false
              }
            ]
          }
        },
        "parallelism": {
          "type": "integer",
          "description": "The number of parallel jobs that will be created based on this step",
          "examples": [
            42
          ]
        },
        "plugins": {
          "anyOf": [
            {
              "type": "array",
              "description": "Array of plugins for this step",
              "items": {
                "oneOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "object",
                    "maxProperties": 1,
                    "examples": [
                      { "docker-compose#v1.0.0": { "run": "app" } }
                    ]
                  }
                ]
              }
            },
            {
              "type": "object",
              "description": "A map of plugins for this step. Deprecated: please use the array syntax."
            }
          ]
        },
        "soft_fail": {
          "$ref": "#/definitions/commonOptions/softFail"
        },
        "retry": {
          "type": "object",
          "description": "The conditions for retrying this step.",
          "properties": {
            "automatic": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "$ref": "#/definitions/commonOptions/automaticRetry"
                },
                {
                  "type": "array",
                  "items": {
                    "$ref": "#/definitions/commonOptions/automaticRetry"
                  }
                }
              ],
              "description": "Whether to allow a job to retry automatically. If set to true, the retry conditions are set to the default value.",
              "default": [
                {
                  "exit_status": "*",
                  "limit": 2
                }
              ]
            },
            "manual": {
              "description": "Whether to allow a job to be retried manually",
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "object",
                  "properties": {
                    "allowed": {
                      "type": "boolean",
                      "description": "Whether or not this job can be retried manually",
                      "default": true
                    },
                    "permit_on_passed": {
                      "type": "boolean",
                      "description": "Whether or not this job can be retried after it has passed",
                      "default": true
                    },
                    "reason": {
                      "type": "string",
                      "description": "A string that will be displayed in a tooltip on the Retry button in Buildkite. This will only be displayed if the allowed attribute is set to false.",
                      "examples": [
                        "No retries allowed on deploy steps"
                      ]
                    }
                  },
                  "additionalProperties": false
                }
              ]
            }
          }
        },
        "skip": {
          "$ref": "#/definitions/commonOptions/skip"
        },
        "timeout_in_minutes": {
          "type": "integer",
          "description": "The number of minutes to time out a job",
          "minimum": 1,
          "examples": [
            60
          ]
        },
        "type": {
          "type": "string",
          "enum": [ "script", "command", "commands" ]
        },
        "priority": {
          "type": "integer",
          "description": "Priority of the job, higher priorities are assigned to agents",
          "examples": [
            -1,
            1
          ]
        }
      },
      "additionalProperties": false
    },
    "nestedCommandStep": {
      "type": "object",
      "properties": {
        "command": { "$ref": "#/definitions/commandStep" },
        "commands": { "$ref": "#/definitions/commandStep" },
        "script": { "$ref": "#/definitions/commandStep" }
      },
      "additionalProperties": false
    },
    "stringWaitStep": {
      "type": "string",
      "description": "Waits for previous steps to pass before continuing",
      "enum": [ "wait", "waiter" ]
    },
    "waitStep": {
      "type": "object",
      "properties": {
        "allow_dependency_failure": {
          "$ref": "#/definitions/commonOptions/allowDependencyFailure"
        },
        "continue_on_failure": {
          "description": "Continue to the next steps, even if the previous group of steps fail",
          "type": "boolean"
        },
        "depends_on": {
          "$ref": "#/definitions/commonOptions/dependsOn"
        },
        "id": {
          "$ref": "#/definitions/commonOptions/identifier"
        },
        "identifier": {
          "$ref": "#/definitions/commonOptions/identifier"
        },
        "if": {
          "$ref": "#/definitions/commonOptions/if"
        },
        "key": {
          "$ref": "#/definitions/commonOptions/key"
        },
        "type": {
          "type": "string",
          "enum": [ "wait", "waiter" ]
        },
        "wait": {
          "description": "Waits for previous steps to pass before continuing",
          "anyOf": [
            { "type": "null" },
            { "type": "string", "enum": [ "" ] }
          ]
        },
        "waiter": {
          "anyOf": [
            { "type": "null" },
            { "type": "string", "enum": [ "" ] }
          ]
        }
      },
      "additionalProperties": false
    },
    "nestedWaitStep": {
      "type": "object",
      "properties": {
        "wait": {
          "description": "Waits for previous steps to pass before continuing",
          "$ref": "#/definitions/waitStep"
        },
        "waiter": {
          "$ref": "#/definitions/waitStep"
        }
      },
      "additionalProperties": false
    },
    "triggerStep": {
      "type": "object",
      "properties": {
        "allow_dependency_failure": {
          "$ref": "#/definitions/commonOptions/allowDependencyFailure"
        },
        "async": {
          "type": "boolean",
          "default": false,
          "description": "Whether to continue the build without waiting for the triggered step to complete"
        },
        "branches": {
          "$ref": "#/definitions/commonOptions/branches"
        },
        "build": {
          "type": "object",
          "description": "Properties of the build that will be created when the step is triggered",
          "properties": {
            "branch": {
              "type": "string",
              "description": "The branch for the build",
              "default": "master",
              "examples": [
                "master",
                "feature/xyz"
              ]
            },
            "commit": {
              "type": "string",
              "description": "The commit hash for the build",
              "default": "HEAD",
              "examples": [
                "HEAD",
                "b5fb108"
              ]
            },
            "env": {
              "$ref": "#/definitions/commonOptions/env"
            },
            "label": {
              "$ref": "#/definitions/commonOptions/label"
            },
            "name": {
              "$ref": "#/definitions/commonOptions/label"
            },
            "message": {
              "type": "string",
              "description": "The message for the build (supports emoji)",
              "default": "The label of the trigger step",
              "examples": [
                "Deployment 123 :rocket:"
              ]
            },
            "meta_data": {
              "type": "object",
              "description": "Meta-data for the build",
              "examples": [
                { "server": "i-b244e37160c" }
              ]
            },
            "trigger": {
              "type": "string",
              "description": "The slug of the pipeline to create a build",
              "examples": [
                "myapp-deploy"
              ]
            },
            "type": {
              "type": "string",
              "enum": [ "trigger" ]
            }
          },
          "additionalProperties": false
        },
        "depends_on": {
          "$ref": "#/definitions/commonOptions/dependsOn"
        },
        "id": {
          "$ref": "#/definitions/commonOptions/identifier"
        },
        "identifier": {
          "$ref": "#/definitions/commonOptions/identifier"
        },
        "if": {
          "$ref": "#/definitions/commonOptions/if"
        },
        "key": {
          "$ref": "#/definitions/commonOptions/key"
        },
        "label": {
          "$ref": "#/definitions/commonOptions/label"
        },
        "name": {
          "$ref": "#/definitions/commonOptions/label"
        },
        "type": {
          "type": "string",
          "enum": [ "trigger" ]
        },
        "trigger": {
          "type": "string",
          "description": "The slug of the pipeline to create a build"
        },
        "skip": {
          "$ref": "#/definitions/commonOptions/skip"
        },
        "soft_fail": {
          "$ref": "#/definitions/commonOptions/softFail"
        }
      },
      "additionalProperties": false
    },
    "nestedTriggerStep": {
      "type": "object",
      "properties": {
        "trigger": {
          "$ref": "#/definitions/triggerStep"
        }
      },
      "additionalProperties": false
    },
    "groupStep": {
      "properties": {
        "depends_on": {
          "$ref": "#/definitions/commonOptions/dependsOn"
        },
        "group": {
          "type": "string",
          "description": "The name to give to this group of steps",
          "examples": [ "Tests" ]
        },
        "id": {
          "$ref": "#/definitions/commonOptions/identifier"
        },
        "identifier": {
          "$ref": "#/definitions/commonOptions/identifier"
        },
        "if": {
          "$ref": "#/definitions/commonOptions/if"
        },
        "key": {
          "$ref": "#/definitions/commonOptions/key"
        },
        "label": {
          "$ref": "#/definitions/groupStep/properties/group"
        },
        "name": {
          "$ref": "#/definitions/groupStep/properties/label"
        },
        "steps": {
          "type": "array",
          "description": "A list of steps",
          "items": {
            "anyOf": [
              { "$ref": "#/definitions/stringBlockStep" },
              { "$ref": "#/definitions/blockStep" },
              { "$ref": "#/definitions/commandStep" },
              { "$ref": "#/definitions/nestedCommandStep" },
              { "$ref": "#/definitions/triggerStep" },
              { "$ref": "#/definitions/nestedTriggerStep" },
              { "$ref": "#/definitions/stringInputStep" },
              { "$ref": "#/definitions/inputStep" },
              { "$ref": "#/definitions/nestedInputStep" },
              { "$ref": "#/definitions/stringWaitStep" },
              { "$ref": "#/definitions/waitStep" },
              { "$ref": "#/definitions/nestedWaitStep" }    
            ]
          },
          "minSize": 1
        },
        "type": {
          "type": "string",
          "enum": [ "group" ]
        }
      },
      "additionalProperties": false
    }
  },
  "properties": {
    "env": {
      "$ref": "#/definitions/commonOptions/env"
    },
    "agents": {
      "$ref": "#/definitions/commonOptions/agents"
    },
    "notify": {
      "$ref": "#/definitions/commonOptions/buildNotify"
    },
    "steps": {
      "description": "A list of steps",
      "type": "array",
      "items": {
        "anyOf": [
          { "$ref": "#/definitions/blockStep" },
          { "$ref": "#/definitions/nestedBlockStep" },
          { "$ref": "#/definitions/stringBlockStep" },
          { "$ref": "#/definitions/inputStep" },
          { "$ref": "#/definitions/nestedInputStep" },
          { "$ref": "#/definitions/stringInputStep" },
          { "$ref": "#/definitions/commandStep" },
          { "$ref": "#/definitions/nestedCommandStep" },
          { "$ref": "#/definitions/stringWaitStep" },
          { "$ref": "#/definitions/waitStep" },
          { "$ref": "#/definitions/nestedWaitStep" },
          { "$ref": "#/definitions/triggerStep" },
          { "$ref": "#/definitions/nestedTriggerStep" },
          { "$ref": "#/definitions/groupStep" }
        ]
      }
    }
  }
}