{
    "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" }
                ]
            }
        }
    }
}