# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand. overlay: 1.0.0 info: title: API Evangelist conversational phrasing for Microsoft Azure Dev Ops API version: 1.0.0 extends: openapi/microsoft-azure-dev-ops-api-openapi.yml actions: - target: $.info update: x-apievangelist-phrasing: method: generated generated: '2026-10-01' generator: build-phrasing.py label: Generated by API Evangelist operations: 31 - target: $.paths['/providers/Microsoft.ADHybridHealthService/reports/DevOps/IsDevOps'].get update: x-apievangelist-phrasing: intent: Check whether I have DevOps access in Connect Health effect: read questions: - Am I enabled for DevOps access in Azure AD Connect Health? - Can I tell whether my user has the Connect Health DevOps flag turned on? instructions: - text: Check if my user is enabled for Connect Health DevOps access. - text: Run the Connect Health DevOps access check with API version {version}. slots: version: query.api-version method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName}/devops/default/listAvailableAzureDevOpsOrgs'].post update: x-apievangelist-phrasing: intent: List Azure DevOps orgs my connector token can reach effect: read questions: - Which Azure DevOps organizations can the token behind my security connector access? - Can I see every Azure DevOps org available to onboard, not just the ones already onboarded? instructions: - text: List all Azure DevOps organizations reachable by the token on security connector {connector}. slots: connector: path.securityConnectorName - text: Show which Azure DevOps orgs I could still onboard to connector {connector}. slots: connector: path.securityConnectorName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName}/devops/default/azureDevOpsOrgs'].get update: x-apievangelist-phrasing: intent: List Azure DevOps orgs onboarded to a connector effect: read questions: - What Azure DevOps organizations are already onboarded to my Defender security connector? - Which Azure DevOps orgs is my connector currently monitoring? instructions: - text: List the Azure DevOps organizations onboarded to connector {connector}. slots: connector: path.securityConnectorName - text: Show me the monitored Azure DevOps orgs on security connector {connector}. slots: connector: path.securityConnectorName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName}/devops/default/azureDevOpsOrgs/{orgName}'].get update: x-apievangelist-phrasing: intent: Get a monitored Azure DevOps organization effect: read questions: - How do I look up one monitored Azure DevOps organization on a security connector? - Can I check the onboarding details of a single Azure DevOps org? instructions: - text: Get monitored Azure DevOps org {org} on connector {connector}. slots: org: path.orgName connector: path.securityConnectorName - text: Show the details of Azure DevOps organization {org} under security connector {connector}. slots: org: path.orgName connector: path.securityConnectorName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName}/devops/default/azureDevOpsOrgs/{orgName}'].put update: x-apievangelist-phrasing: intent: Onboard or replace a monitored Azure DevOps org effect: write questions: - How do I onboard an Azure DevOps organization to my security connector? - Can I create or fully overwrite the monitoring settings for an Azure DevOps org? instructions: - text: Onboard Azure DevOps org {org} to connector {connector}. slots: org: path.orgName connector: path.securityConnectorName - text: Create or replace the monitored Azure DevOps org {org} on {connector} with properties {properties}. slots: org: path.orgName connector: path.securityConnectorName properties: requestBody.properties method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName}/devops/default/azureDevOpsOrgs/{orgName}'].patch update: x-apievangelist-phrasing: intent: Patch a monitored Azure DevOps org's details effect: write questions: - Can I change just some settings of an Azure DevOps org that's already onboarded? - What's the way to partially update a monitored Azure DevOps organization? instructions: - text: Patch the monitored Azure DevOps org {org} on connector {connector} with {properties}. slots: org: path.orgName connector: path.securityConnectorName properties: requestBody.properties - text: Update settings on already-onboarded Azure DevOps org {org} in {connector}. slots: org: path.orgName connector: path.securityConnectorName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName}/devops/default/azureDevOpsOrgs/{orgName}/projects'].get update: x-apievangelist-phrasing: intent: List Azure DevOps projects onboarded to a connector effect: read questions: - Which projects in an Azure DevOps org are onboarded to my security connector? - Can I list all monitored projects under one Azure DevOps organization? instructions: - text: List onboarded projects in Azure DevOps org {org} on connector {connector}. slots: org: path.orgName connector: path.securityConnectorName - text: Show every monitored Azure DevOps project under org {org} for {connector}. slots: org: path.orgName connector: path.securityConnectorName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName}/devops/default/azureDevOpsOrgs/{orgName}/projects/{projectName}'].get update: x-apievangelist-phrasing: intent: Get a monitored Azure DevOps project effect: read questions: - How do I fetch a single monitored Azure DevOps project? - Is a specific Azure DevOps project onboarded to my connector, and what are its details? instructions: - text: Get Azure DevOps project {project} in org {org} on connector {connector}. slots: project: path.projectName org: path.orgName connector: path.securityConnectorName - text: Show monitoring details for project {project} of Azure DevOps org {org} on {connector}. slots: project: path.projectName org: path.orgName connector: path.securityConnectorName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName}/devops/default/azureDevOpsOrgs/{orgName}/projects/{projectName}'].put update: x-apievangelist-phrasing: intent: Onboard or replace a monitored Azure DevOps project effect: write questions: - How do I onboard a single Azure DevOps project to the security connector? - Can I create or overwrite the monitored resource for one Azure DevOps project? instructions: - text: Onboard Azure DevOps project {project} in org {org} to connector {connector}. slots: project: path.projectName org: path.orgName connector: path.securityConnectorName - text: Create or replace monitored project {project} under org {org} on {connector} using {properties}. slots: project: path.projectName org: path.orgName connector: path.securityConnectorName properties: requestBody.properties method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName}/devops/default/azureDevOpsOrgs/{orgName}/projects/{projectName}'].patch update: x-apievangelist-phrasing: intent: Patch a monitored Azure DevOps project effect: write questions: - Can I partially update an Azure DevOps project that's already being monitored? - What call changes a few fields on an onboarded Azure DevOps project? instructions: - text: Patch onboarded Azure DevOps project {project} in org {org} on {connector} with {properties}. slots: project: path.projectName org: path.orgName connector: path.securityConnectorName properties: requestBody.properties - text: Update the existing monitored project {project} of org {org} on connector {connector}. slots: project: path.projectName org: path.orgName connector: path.securityConnectorName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName}/devops/default/azureDevOpsOrgs/{orgName}/projects/{projectName}/repos'].get update: x-apievangelist-phrasing: intent: List Azure DevOps repos onboarded to a connector effect: read questions: - Which Azure DevOps repositories in a project are onboarded to my security connector? - Can I list the monitored Azure Repos for one Azure DevOps project? instructions: - text: List onboarded Azure DevOps repos in project {project} of org {org} on {connector}. slots: project: path.projectName org: path.orgName connector: path.securityConnectorName - text: Show the monitored repositories under Azure DevOps project {project} in org {org} for connector {connector}. slots: project: path.projectName org: path.orgName connector: path.securityConnectorName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName}/devops/default/azureDevOpsOrgs/{orgName}/projects/{projectName}/repos/{repoName}'].get update: x-apievangelist-phrasing: intent: Get a monitored Azure DevOps repository effect: read questions: - How do I look up one monitored Azure DevOps repository on the connector? - What are the onboarding details of a specific Azure Repos repository? instructions: - text: Get Azure DevOps repo {repo} in project {project}, org {org}, connector {connector}. slots: repo: path.repoName project: path.projectName org: path.orgName connector: path.securityConnectorName - text: Show monitoring details of Azure DevOps repository {repo} in project {project} of org {org} on {connector}. slots: repo: path.repoName project: path.projectName org: path.orgName connector: path.securityConnectorName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName}/devops/default/azureDevOpsOrgs/{orgName}/projects/{projectName}/repos/{repoName}'].put update: x-apievangelist-phrasing: intent: Onboard or replace a monitored Azure DevOps repo effect: write questions: - How do I onboard one Azure DevOps repository to my security connector? - Can I create or overwrite the monitored resource for a single Azure Repos repo? instructions: - text: Onboard Azure DevOps repo {repo} from project {project} in org {org} to connector {connector}. slots: repo: path.repoName project: path.projectName org: path.orgName connector: path.securityConnectorName - text: Create or replace monitored Azure DevOps repo {repo} (project {project}, org {org}, connector {connector}) with {properties}. slots: repo: path.repoName project: path.projectName org: path.orgName connector: path.securityConnectorName properties: requestBody.properties method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName}/devops/default/azureDevOpsOrgs/{orgName}/projects/{projectName}/repos/{repoName}'].patch update: x-apievangelist-phrasing: intent: Patch a monitored Azure DevOps repository effect: write questions: - Can I partially update an Azure DevOps repo that's already onboarded to the connector? - What call tweaks settings on a monitored Azure Repos repository? instructions: - text: Patch onboarded Azure DevOps repo {repo} in project {project}, org {org}, connector {connector} with {properties}. slots: repo: path.repoName project: path.projectName org: path.orgName connector: path.securityConnectorName properties: requestBody.properties - text: Update the existing monitored repository {repo} of Azure DevOps project {project} in org {org} on {connector}. slots: repo: path.repoName project: path.projectName org: path.orgName connector: path.securityConnectorName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName}/devops'].get update: x-apievangelist-phrasing: intent: List DevOps configurations on a security connector effect: read questions: - What DevOps configurations exist on my Defender for Cloud security connector? - Can I list all DevOps configuration entries for a connector? instructions: - text: List DevOps configurations for security connector {connector}. slots: connector: path.securityConnectorName - text: Show every DevOps configuration attached to connector {connector}. slots: connector: path.securityConnectorName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName}/devops/default'].get update: x-apievangelist-phrasing: intent: Get a connector's default DevOps configuration effect: read questions: - How do I read the default DevOps configuration of a security connector? - What auto-discovery and authorization settings does my connector's DevOps configuration hold? instructions: - text: Get the default DevOps configuration of connector {connector}. slots: connector: path.securityConnectorName - text: Show the current DevOps configuration settings on security connector {connector}. slots: connector: path.securityConnectorName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName}/devops/default'].put update: x-apievangelist-phrasing: intent: Create or replace a connector's DevOps configuration effect: write questions: - How do I set up a DevOps configuration on a new security connector? - Can I overwrite the whole DevOps configuration for a connector in one call? instructions: - text: Create the DevOps configuration for security connector {connector} with {properties}. slots: connector: path.securityConnectorName properties: requestBody.properties - text: Set up or fully replace the DevOps configuration on connector {connector}. slots: connector: path.securityConnectorName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName}/devops/default'].delete update: x-apievangelist-phrasing: intent: Delete a connector's DevOps configuration effect: destructive questions: - How do I remove the DevOps connector configuration from a security connector? - What happens to onboarding if I delete a connector's DevOps configuration? instructions: - text: Delete the DevOps configuration on security connector {connector}. slots: connector: path.securityConnectorName - text: Remove DevOps connectivity from connector {connector}. slots: connector: path.securityConnectorName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName}/devops/default'].patch update: x-apievangelist-phrasing: intent: Patch a connector's DevOps configuration effect: write questions: - Can I change only part of an existing DevOps configuration on my connector? - Which call partially updates the DevOps settings on a security connector? instructions: - text: Patch the existing DevOps configuration on connector {connector} with {properties}. slots: connector: path.securityConnectorName properties: requestBody.properties - text: Update a few DevOps configuration settings on security connector {connector}. slots: connector: path.securityConnectorName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName}/devops/default/listAvailableGitHubOwners'].post update: x-apievangelist-phrasing: intent: List GitHub owners my connector token can reach effect: read questions: - Which GitHub owners can the token on my security connector access? - Can I see all GitHub organizations available to onboard, including ones not yet monitored? instructions: - text: List all GitHub owners accessible to the token on connector {connector}. slots: connector: path.securityConnectorName - text: Show which GitHub owners I could still onboard to security connector {connector}. slots: connector: path.securityConnectorName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName}/devops/default/gitHubOwners'].get update: x-apievangelist-phrasing: intent: List GitHub owners onboarded to a connector effect: read questions: - What GitHub owners are already onboarded to my security connector? - Which GitHub organizations is Defender for Cloud monitoring through this connector? instructions: - text: List GitHub owners onboarded to connector {connector}. slots: connector: path.securityConnectorName - text: Show the monitored GitHub owners on security connector {connector}. slots: connector: path.securityConnectorName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName}/devops/default/gitHubOwners/{ownerName}'].get update: x-apievangelist-phrasing: intent: Get a monitored GitHub owner effect: read questions: - How do I look up one monitored GitHub owner on my connector? - Can I check the onboarding state of a specific GitHub organization? instructions: - text: Get monitored GitHub owner {owner} on connector {connector}. slots: owner: path.ownerName connector: path.securityConnectorName - text: Show details for GitHub owner {owner} under security connector {connector}. slots: owner: path.ownerName connector: path.securityConnectorName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName}/devops/default/gitHubOwners/{ownerName}/repos'].get update: x-apievangelist-phrasing: intent: List GitHub repos onboarded to a connector effect: read questions: - Which GitHub repositories under an owner are onboarded to my security connector? - Can I list the monitored repos for one GitHub organization? instructions: - text: List onboarded GitHub repos for owner {owner} on connector {connector}. slots: owner: path.ownerName connector: path.securityConnectorName - text: Show every monitored GitHub repository of {owner} through {connector}. slots: owner: path.ownerName connector: path.securityConnectorName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName}/devops/default/gitHubOwners/{ownerName}/repos/{repoName}'].get update: x-apievangelist-phrasing: intent: Get a monitored GitHub repository effect: read questions: - How do I fetch one monitored GitHub repository from the connector? - Is a particular GitHub repo onboarded, and what are its details? instructions: - text: Get GitHub repo {repo} of owner {owner} on connector {connector}. slots: repo: path.repoName owner: path.ownerName connector: path.securityConnectorName - text: Show monitoring details for GitHub repository {owner}/{repo} on {connector}. slots: repo: path.repoName owner: path.ownerName connector: path.securityConnectorName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName}/devops/default/listAvailableGitLabGroups'].post update: x-apievangelist-phrasing: intent: List GitLab groups my connector token can reach effect: read questions: - Which GitLab groups can the token on my security connector access? - Can I see every GitLab group available to onboard, not only monitored ones? instructions: - text: List all GitLab groups accessible to the token on connector {connector}. slots: connector: path.securityConnectorName - text: Show which GitLab groups I could still onboard to security connector {connector}. slots: connector: path.securityConnectorName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName}/devops/default/gitLabGroups'].get update: x-apievangelist-phrasing: intent: List GitLab groups onboarded to a connector effect: read questions: - What GitLab groups are already onboarded to my security connector? - Which top-level GitLab groups is my connector monitoring? instructions: - text: List GitLab groups onboarded to connector {connector}. slots: connector: path.securityConnectorName - text: Show the monitored GitLab groups on security connector {connector}. slots: connector: path.securityConnectorName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName}/devops/default/gitLabGroups/{groupFQName}'].get update: x-apievangelist-phrasing: intent: Get a monitored GitLab group by full name effect: read questions: - How do I look up a monitored GitLab group by its fully qualified name? - Can I check the onboarding details of one GitLab group? instructions: - text: Get monitored GitLab group {group} on connector {connector}. slots: group: path.groupFQName connector: path.securityConnectorName - text: Show details for GitLab group with full name {group} on {connector}. slots: group: path.groupFQName connector: path.securityConnectorName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName}/devops/default/gitLabGroups/{groupFQName}/listSubgroups'].post update: x-apievangelist-phrasing: intent: List onboarded subgroups of a GitLab group effect: read questions: - Which nested subgroups of a GitLab group are onboarded to my connector? - Can I see the child groups under one monitored GitLab group? instructions: - text: List onboarded subgroups of GitLab group {group} on connector {connector}. slots: group: path.groupFQName connector: path.securityConnectorName - text: Show the nested GitLab subgroups under {group} monitored by {connector}. slots: group: path.groupFQName connector: path.securityConnectorName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName}/devops/default/gitLabGroups/{groupFQName}/projects'].get update: x-apievangelist-phrasing: intent: List GitLab projects owned by a monitored group effect: read questions: - Which GitLab projects directly owned by a group are onboarded to my connector? - Can I list monitored projects in one GitLab group, excluding subgroup projects? instructions: - text: List GitLab projects directly owned by group {group} on connector {connector}. slots: group: path.groupFQName connector: path.securityConnectorName - text: Show onboarded projects in GitLab group {group} for security connector {connector}. slots: group: path.groupFQName connector: path.securityConnectorName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName}/devops/default/gitLabGroups/{groupFQName}/projects/{projectName}'].get update: x-apievangelist-phrasing: intent: Get a monitored GitLab project effect: read questions: - How do I fetch one monitored GitLab project by group and project name? - Is a specific GitLab project onboarded to my connector? instructions: - text: Get GitLab project {project} in group {group} on connector {connector}. slots: project: path.projectName group: path.groupFQName connector: path.securityConnectorName - text: Show monitoring details of GitLab project {group}/{project} on {connector}. slots: project: path.projectName group: path.groupFQName connector: path.securityConnectorName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName}/devops/default/operationResults/{operationResultId}'].get update: x-apievangelist-phrasing: intent: Check a DevOps long-running operation result effect: read questions: - How do I check whether a long-running DevOps connector operation has finished? - Where do I poll for the result of an async DevOps onboarding call? instructions: - text: Get DevOps operation result {operation} on connector {connector}. slots: operation: path.operationResultId connector: path.securityConnectorName - text: Check the status of long-running DevOps operation {operation} for security connector {connector}. slots: operation: path.operationResultId connector: path.securityConnectorName method: generated generated: '2026-10-01'