Microsoft Azure · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Microsoft Azure Microsoft.ServiceLinker Connector API

10 actions 10 updates phrasing extends openapi/microsoft-azure-connector-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 10

$.info
$.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.ServiceLinker/locations/{location}/dryruns'].get
$.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.ServiceLinker/locations/{location}/dryruns/{dryrunName}'].get
$.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.ServiceLinker/locations/{location}/dryruns/{dryrunName}'].put
$.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.ServiceLinker/locations/{location}/dryruns/{dryrunName}'].delete
$.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.ServiceLinker/locations/{location}/dryruns/{dryrunName}'].patch
$.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.ServiceLinker/locations/{location}/connectors/{connectorName}'].delete
$.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.ServiceLinker/locations/{location}/connectors/{connectorName}'].patch
$.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.ServiceLinker/locations/{location}/connectors/{connectorName}/validate'].post
$.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.ServiceLinker/locations/{location}/connectors/{connectorName}/generateConfigurations'].post

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 Microsoft.ServiceLinker Connector API
  version: 1.0.0
extends: openapi/microsoft-azure-connector-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: 9
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.ServiceLinker/locations/{location}/dryruns'].get
  update:
    x-apievangelist-phrasing:
      intent: List Service Connector dry-run jobs
      effect: read
      questions:
      - Which Service Connector dry-run checks have I run in this location?
      - Can I see all the pre-creation dry runs for my connectors?
      instructions:
      - text: List Service Connector dry-run jobs in subscription {subscription} and location {location}.
        slots:
          subscription: path.subscriptionId
          location: path.location
      - text: Show every connector dry run I have in subscription {subscription}.
        slots:
          subscription: path.subscriptionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.ServiceLinker/locations/{location}/dryruns/{dryrunName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Service Connector dry-run job
      effect: read
      questions:
      - How do I see the results of a Service Connector dry run?
      - Did my connector dry run find missing permissions or other blockers?
      instructions:
      - text: Get dry-run job {dryrun} in location {location} of subscription {subscription}.
        slots:
          dryrun: path.dryrunName
          location: path.location
          subscription: path.subscriptionId
      - text: Show the check results of connector dry run {dryrun}.
        slots:
          dryrun: path.dryrunName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.ServiceLinker/locations/{location}/dryruns/{dryrunName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Start a Service Connector dry run before creation
      effect: write
      questions:
      - How do I test a Service Connector setup before actually creating the connection?
      - Can I run pre-creation checks on a connector configuration?
      instructions:
      - text: Create dry-run job {dryrun} in subscription {subscription} with parameters {properties}.
        slots:
          dryrun: path.dryrunName
          subscription: path.subscriptionId
          properties: requestBody.properties
      - text: Run connector pre-checks in {location} as new dry run {dryrun}.
        slots:
          location: path.location
          dryrun: path.dryrunName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.ServiceLinker/locations/{location}/dryruns/{dryrunName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Service Connector dry-run job
      effect: destructive
      questions:
      - How do I clean up an old Service Connector dry run?
      - Can I delete a dry-run job once I've reviewed it?
      instructions:
      - text: Delete dry-run job {dryrun} in subscription {subscription}.
        slots:
          dryrun: path.dryrunName
          subscription: path.subscriptionId
      - text: Remove connector dry run {dryrun} from location {location}.
        slots:
          dryrun: path.dryrunName
          location: path.location
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.ServiceLinker/locations/{location}/dryruns/{dryrunName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a Service Connector dry-run job
      effect: write
      questions:
      - How do I re-run a Service Connector dry run with changed parameters?
      - Can I edit an existing dry-run job instead of creating another one?
      instructions:
      - text: Update dry-run job {dryrun} in subscription {subscription} with {properties}.
        slots:
          dryrun: path.dryrunName
          subscription: path.subscriptionId
          properties: requestBody.properties
      - text: Change the parameters of existing connector dry run {dryrun} in {location} to {properties}.
        slots:
          dryrun: path.dryrunName
          location: path.location
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.ServiceLinker/locations/{location}/connectors/{connectorName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Service Connector
      effect: destructive
      questions:
      - How do I delete a Service Connector that links my app to a backing service?
      - Can I remove a location-scoped connector entirely?
      instructions:
      - text: Delete Service Connector {connector} in subscription {subscription}.
        slots:
          connector: path.connectorName
          subscription: path.subscriptionId
      - text: Remove the connector named {connector} in location {location}.
        slots:
          connector: path.connectorName
          location: path.location
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.ServiceLinker/locations/{location}/connectors/{connectorName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a Service Connector
      effect: write
      questions:
      - How do I change the auth or target settings of an existing Service Connector?
      - Can I patch a connector without recreating it?
      instructions:
      - text: Update Service Connector {connector} in subscription {subscription} with {properties}.
        slots:
          connector: path.connectorName
          subscription: path.subscriptionId
          properties: requestBody.properties
      - text: Patch connector {connector} in {location} to use settings {properties}.
        slots:
          connector: path.connectorName
          location: path.location
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.ServiceLinker/locations/{location}/connectors/{connectorName}/validate'].post
  update:
    x-apievangelist-phrasing:
      intent: Validate a Service Connector
      effect: read
      questions:
      - How do I check whether my Service Connector is working correctly?
      - Is there a way to validate a connector's connectivity and auth?
      instructions:
      - text: Validate Service Connector {connector} in subscription {subscription}.
        slots:
          connector: path.connectorName
          subscription: path.subscriptionId
      - text: Run a health validation on connector {connector} in location {location}.
        slots:
          connector: path.connectorName
          location: path.location
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.ServiceLinker/locations/{location}/connectors/{connectorName}/generateConfigurations'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate app configuration for a Service Connector
      effect: write
      questions:
      - How do I generate the environment variables my app needs from a Service Connector?
      - Can I customize the configuration key names a connector generates?
      - Can connector configurations be written into an App Configuration store?
      instructions:
      - text: Generate configurations for Service Connector {connector} in location {location}.
        slots:
          connector: path.connectorName
          location: path.location
      - text: Generate connector {connector} configs using customized keys {customized_keys}.
        slots:
          connector: path.connectorName
          customized_keys: requestBody.customizedKeys
      - text: Write connector {connector} configurations to configuration store {store}.
        slots:
          connector: path.connectorName
          store: requestBody.configurationStore
      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-connector-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.

GitHub Google LinkedIn

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