From 3b7411cac0f0a80a744caeeefb591c952ae8eee7 Mon Sep 17 00:00:00 2001 From: Jason McIntosh Date: Thu, 17 Jul 2025 12:58:03 -0400 Subject: [PATCH 1/2] Clarify the permissions that CodeRabbit needs. --- docs/platforms/azure-devops.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/platforms/azure-devops.md b/docs/platforms/azure-devops.md index 12b70765..415a159e 100644 --- a/docs/platforms/azure-devops.md +++ b/docs/platforms/azure-devops.md @@ -94,9 +94,8 @@ Follow these steps to generate the token: 5. Select the organization you want to use the token with or select "All accessible organizations." 6. Enter a name and an expiry date for the token. -7. We need to have read & write access to "Work Items" & "Code" to post reviews - on pull requests. If you are on the Pro tier also add "Build" access for pipeline - failure remediation. +7. We need to have **Read, write, & manage** access to "Work Items" and "Code" to post reviews + on pull requests. If you are on the CodeRabbit Pro tier, you must also grant **Read** access to "Build" for pipeline failure remediation. 8. Click "Create" ![CodeRabbit azure devOps personal access token creation form](/img/integrations/azure-access-token.png) From 30ac13bcb3e0ff0af8c58010a87dc5a7817786b4 Mon Sep 17 00:00:00 2001 From: Jason McIntosh Date: Thu, 17 Jul 2025 13:07:42 -0400 Subject: [PATCH 2/2] Clarify the wording of permission-granting steps. --- docs/platforms/azure-devops.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/platforms/azure-devops.md b/docs/platforms/azure-devops.md index 415a159e..b88ebcd7 100644 --- a/docs/platforms/azure-devops.md +++ b/docs/platforms/azure-devops.md @@ -94,8 +94,8 @@ Follow these steps to generate the token: 5. Select the organization you want to use the token with or select "All accessible organizations." 6. Enter a name and an expiry date for the token. -7. We need to have **Read, write, & manage** access to "Work Items" and "Code" to post reviews - on pull requests. If you are on the CodeRabbit Pro tier, you must also grant **Read** access to "Build" for pipeline failure remediation. -8. Click "Create" +7. Grant **Read, write, & manage** access to "Work Items" and "Code". CodeRabbit needs these permissions to post code reviews on pull requests. +8. If you subscribe to CodeRabbit Pro, then you can also grant **Read** access to "Build" for pipeline failure remediation. +9. Click "Create" ![CodeRabbit azure devOps personal access token creation form](/img/integrations/azure-access-token.png)