View as Markdown

Request Reviews

Request reviews from specific users or teams.

The request_reviews action lets Mergify request reviews from specified users or teams. This is useful when you want to ensure specific team members review certain pull requests.

Parameters

Section titled Parameters
bot_account#{{ author }}, string or null·defaultnull

Mergify can impersonate a GitHub user to request a review on a pull request. If no bot_account is set, Mergify will request the review itself.

random_count#integer or null·defaultnull

Pick random users and teams from the provided lists. When random_count is specified, users and teams can be a dictionary where the key is the login and the value is the weight to use. Weight must be between 1 and 15 included.

teams#list of string or map of integer

The team names to request reviews from.

users#list of string or map of integer

The usernames to request reviews from.

users_from_teams#list of string or map of integer

The team names to get the list of users to request reviews from.

Examples

Section titled Examples

Request a Review for Sensitive Files

Section titled Request a Review for Sensitive Files

Ask the security team to review whenever a pull request changes files under security/.

pull_request_rules:
  - name: request a security review
    conditions:
      - files ~= ^security/
    actions:
      request_reviews:
        teams:
          - security

Was this page helpful?

Edit this page on GitHub