Azure DevOps Configuration

Generate a Personal Access Token (PAT) for Azure DevOps and configure it in RoostGPT.

Step 1: Generate a Personal Access Token

1. Log into dev.azure.com
2. Click on your profile picture in the top-right corner
3. Select "Personal access tokens"
4. Click "New Token"
5. Configure the token:
   • Name: Enter a descriptive name (e.g., RoostGPT)
   • Organization: Select your organization (or "All accessible organizations")
   • Expiration: Set an appropriate expiration date
   • Scopes: Select Custom defined and grant the permissions below
6. Click "Create"
7. Copy the token immediately — it is shown only once

Required Scopes

Scope	Permission	Purpose
Code	Read & Write	Repository access
Pull Request	Read & Write	PR creation and management
Build	Read & Execute	Pipeline triggers
Service Hooks	Read & Write	Webhook subscription management
Work Items	Read	Fetch user stories and requirements

Step 2: Get Your Organization and Project Details

You will need the following values for RoostGPT configuration:

• Organization URL: https://dev.azure.com/{your-organization}
• Project Name: Your Azure DevOps project name
• Repository Name: The repository within the project

Step 3: Add to RoostGPT

Web UI (Connector)

1. Click Connectors in the top navigation bar → Code Repositories
2. Select Azure DevOps
3. Enter:
   • Organization URL: https://dev.azure.com/your-org
   • Personal Access Token: The PAT you generated
   • Username / Organization Name: Required for Azure DevOps

CLI (.env file)

GIT_TYPE=azure
SOURCE_GIT_TOKEN=your_pat_token
SOURCE_OWNER_NAME=your-org-name
SOURCE_PROJECT_NAME=your-project-name
SOURCE_REPO_NAME=your-repo
SOURCE_BASE_BRANCH=main
GIT_HOSTED_URL=https://dev.azure.com/your-org

Webhook Setup

Azure DevOps uses Service Hooks instead of standard webhooks. See the Webhooks guide for step-by-step setup including the required service hook subscriptions for Code Pushed, Pull Request Created, and Pull Request Merged events.