Azure Repos Pull Request

Property	Type	Description
title	string	The title of the pull request.
token	string	The token to use for authorization.
repoId	string	Repo ID of the pull request.
server	string	The hostname of the Azure DevOps service. Defaults to dev.azure.com
project	string	The Project in Azure DevOps.
description	string	The description of the pull request.
autoComplete	boolean	Enable auto-completion of the pull request once policies are met
organization	string	The name of the organization in Azure DevOps.
sourceBranch	string	The branch to merge into the source.
targetBranch	string	The branch to merge into (default: main).
supportsIterations	boolean	Whether or not the PR supports iterations.

Property	Type	Description	Required
type	any	-
properties	any	-

Create a PR from a feature branch to main

Creates a pull request from a feature branch into main after generating files with fetch:template. Use this when your template or prior steps have pushed commits to the feature branch.

Copy

steps:
  - id: fetch-template
    action: fetch:template
    input:
      url: ./templates/service
      values:
        name: ${{ parameters.serviceName }}
        owner: platform

  - id: create-pr
    action: azure:repo:pr
    input:
      organization: acme-inc
      project: Retail
      repoId: 3b1a2e4f-9c12-4a7e-bc3c-84a6d0f8c7a1
      sourceBranch: feature/${{ parameters.serviceName }}
      targetBranch: main
      title: "feat: add ${{ parameters.serviceName }} service"
      description: "Initial scaffold and CI setup for ${{ parameters.serviceName }}"
      supportsIterations: true
      token: ${{ secrets.azure.token }}

Auto complete a hotfix PR into a release branch

Creates a pull request from a hotfix branch into a release branch and enables auto completion when policies pass. Use this for small, policy-gated hotfixes prepared by earlier steps.

Copy

steps:
  - id: fetch-template
    action: fetch:template
    input:
      url: ./templates/hotfix
      values:
        issue: ${{ parameters.issueId }}
        owner: retail-team

  - id: release-pr
    action: azure:repo:pr
    input:
      organization: acme-inc
      project: Retail
      repoId: 7f9a1b22-4ce1-4a42-9f71-1d1a6b8b2e55
      sourceBranch: hotfix/${{ parameters.issueId }}-payment-retry
      targetBranch: release/1.4
      title: "fix(payment): retry on transient errors"
      description: "Hotfix for payment retries related to ${{ parameters.issueId }}"
      autoComplete: true
      supportsIterations: true
      token: ${{ parameters.azurePat }}

Create a PR on Azure DevOps Server with a custom host

Creates a pull request on an on-prem Azure DevOps Server instance. Use this when your organization hosts ADO Server with a non default hostname.

Copy

steps:
  - id: fetch-template
    action: fetch:template
    input:
      url: ./templates/logging-update
      values:
        owner: platform
        component: shared-logging

  - id: create-pr-onprem
    action: azure:repo:pr
    input:
      server: ado.internal.corp
      organization: DefaultCollection
      project: Platform
      repoId: 2d3c4b5a-6e7f-8901-a2b3-c4d5e6f78901
      sourceBranch: feature/improve-logging
      targetBranch: main
      title: "chore(logging): standardize logging format"
      description: "Apply structured logging and update pipeline config"
      supportsIterations: false
      token: ${{ secrets.azure.serverToken }}

Create a PR targeting a develop branch

Creates a pull request into develop instead of the default main. Use this for trunk based workflows where develop is the integration branch.

Copy

steps:
  - id: fetch-template
    action: fetch:template
    input:
      url: ./templates/microservice
      values:
        name: ${{ parameters.serviceName }}
        domain: catalogue

  - id: pr-to-develop
    action: azure:repo:pr
    input:
      organization: acme-inc
      project: Services
      repoId: e1c2d3f4-a5b6-7890-c1d2-e3f4a5b67890
      sourceBranch: feature/${{ parameters.serviceName }}-catalog
      targetBranch: develop
      title: "feat(${{ parameters.serviceName }}): initial service skeleton"
      description: "Scaffolded service, added linting and basic health endpoint"
      supportsIterations: true

Create a PR for an automated dependency update branch

Creates a pull request for an automated dependency update branch and enables iterations to support review updates. Use this when prior automation has pushed dependency changes.

Copy

steps:
  - id: fetch-template
    action: fetch:template
    input:
      url: ./templates/dependency-update
      values:
        owner: sre
        tool: renovate

  - id: dep-update-pr
    action: azure:repo:pr
    input:
      organization: acme-inc
      project: Web
      repoId: 9a8b7c6d-5e4f-3a2b-1c0d-9e8f7a6b5c4d
      sourceBranch: renovate/npm-typescript-5.x
      targetBranch: main
      title: "chore(deps): update typescript to v5"
      description: "Automated dependency update generated by Renovate"
      supportsIterations: true
      autoComplete: false

Input Schema

Output Schema

Usage Examples

Create a PR from a feature branch to main

Auto complete a hotfix PR into a release branch

Create a PR on Azure DevOps Server with a custom host

Create a PR targeting a develop branch

Create a PR for an automated dependency update branch

Other actions in @parfuemerie-douglas/scaffolder-backend-module-azure-repositories

Clone Azure Repository

Azure Repo Push