require

The require setting specifies how many approvals are needed for each scope before the PR can be merged. By default require = 0 and approvals are not required.

[[scopes]]
name = "app"
reviewers = ["dev1", "dev2"]
require = 1

Behavior:

  • If require is not met, the PR will be blocked from merging.
  • If anybody in the scope rejects the PR, it will be blocked from merging.
  • The PR author's own approval never counts — even on platforms that allow self-approval. Use author_value to count the author automatically.
  • If require can never be met for a PR (for example, the PR author is the only listed reviewer), the scope reports an error instead of waiting forever.