Microsoft Azure · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Microsoft Azure Dev Ops API

32 actions 32 updates phrasing extends openapi/microsoft-azure-dev-ops-api-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for Microsoft Azure's API. It is a proposal applied on top of the contract, not a document Microsoft Azure publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 32 · first 16 shown; the file carries all of them

$.info
$.paths['/providers/Microsoft.ADHybridHealthService/reports/DevOps/IsDevOps'].get
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName}/devops/default/listAvailableAzureDevOpsOrgs'].post
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName}/devops/default/azureDevOpsOrgs'].get
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName}/devops/default/azureDevOpsOrgs/{orgName}'].get
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName}/devops/default/azureDevOpsOrgs/{orgName}'].put
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName}/devops/default/azureDevOpsOrgs/{orgName}'].patch
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName}/devops/default/azureDevOpsOrgs/{orgName}/projects'].get
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName}/devops/default/azureDevOpsOrgs/{orgName}/projects/{projectName}'].get
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName}/devops/default/azureDevOpsOrgs/{orgName}/projects/{projectName}'].put
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName}/devops/default/azureDevOpsOrgs/{orgName}/projects/{projectName}'].patch
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName}/devops/default/azureDevOpsOrgs/{orgName}/projects/{projectName}/repos'].get
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName}/devops/default/azureDevOpsOrgs/{orgName}/projects/{projectName}/repos/{repoName}'].get
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName}/devops/default/azureDevOpsOrgs/{orgName}/projects/{projectName}/repos/{repoName}'].put
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName}/devops/default/azureDevOpsOrgs/{orgName}/projects/{projectName}/repos/{repoName}'].patch
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName}/devops'].get

OpenAPI Overlay

Raw ↑
# 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'

Work with this as data

Every overlay here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for openapi overlays

4 MCP tools reach this
  • find_overlaysBrowse and filter every overlay in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This overlay
curl "https://apis.io/api/v1/overlays/microsoft-azure-dev-ops-api-phrasing-overlay"
All openapi overlays
curl "https://apis.io/api/v1/overlays?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.