# 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 Workspaces API
  version: 1.0.0
extends: openapi/microsoft-azure-workspaces-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: 70
- target: $.paths['/workspaces/{workspaceName}/apis'].get
  update:
    x-apievangelist-phrasing:
      intent: List APIs in an API Center workspace
      effect: read
      questions:
      - Which APIs are registered in my API Center workspace?
      - Can I page through the API inventory of an API Center workspace a few at a time?
      instructions:
      - text: List the APIs registered in API Center workspace {workspace}.
        slots:
          workspace: path.workspaceName
      - text: Show the first {top} APIs in API Center workspace {workspace}.
        slots:
          top: query.top
          workspace: path.workspaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/workspaces/{workspaceName}/apis/{apiName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one API from an API Center workspace
      effect: read
      questions:
      - How do I look up a single API's details in my API Center inventory?
      - What does API Center record about one registered API?
      instructions:
      - text: Get API {api} from API Center workspace {workspace}.
        slots:
          api: path.apiName
          workspace: path.workspaceName
      - text: Show the API Center catalog entry for {api} in {workspace}.
        slots:
          api: path.apiName
          workspace: path.workspaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/workspaces/{workspaceName}/apis/{apiName}/deployments'].get
  update:
    x-apievangelist-phrasing:
      intent: List deployments of an API in API Center
      effect: read
      questions:
      - Where is a given API deployed according to API Center?
      - Can I see every deployment recorded for one API in my API inventory?
      instructions:
      - text: List the deployments of API {api} in API Center workspace {workspace}.
        slots:
          api: path.apiName
          workspace: path.workspaceName
      - text: Show where API {api} is deployed in workspace {workspace}.
        slots:
          api: path.apiName
          workspace: path.workspaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/workspaces/{workspaceName}/apis/{apiName}/deployments/{deploymentName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one deployment of an API in API Center
      effect: read
      questions:
      - How do I read the details of a single API deployment in API Center?
      - What environment and server does a specific API deployment point at?
      instructions:
      - text: Get deployment {deployment} of API {api} in API Center workspace {workspace}.
        slots:
          deployment: path.deploymentName
          api: path.apiName
          workspace: path.workspaceName
      - text: Show the {deployment} deployment record for API {api} in {workspace}.
        slots:
          deployment: path.deploymentName
          api: path.apiName
          workspace: path.workspaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/workspaces/{workspaceName}/apis/{apiName}/versions'].get
  update:
    x-apievangelist-phrasing:
      intent: List versions of an API in API Center
      effect: read
      questions:
      - Which versions of an API are tracked in API Center?
      - Can I list the version history of one API in my API Center workspace?
      instructions:
      - text: List the versions of API {api} in API Center workspace {workspace}.
        slots:
          api: path.apiName
          workspace: path.workspaceName
      - text: Show all tracked versions of {api} in {workspace}.
        slots:
          api: path.apiName
          workspace: path.workspaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/workspaces/{workspaceName}/apis/{apiName}/versions/{versionName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one version of an API in API Center
      effect: read
      questions:
      - How do I check the lifecycle stage of a specific API version in API Center?
      - What does API Center store about a single API version?
      instructions:
      - text: Get version {version} of API {api} in API Center workspace {workspace}.
        slots:
          version: path.versionName
          api: path.apiName
          workspace: path.workspaceName
      - text: Show the details of {api} version {version} in {workspace}.
        slots:
          version: path.versionName
          api: path.apiName
          workspace: path.workspaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/workspaces/{workspaceName}/apis/{apiName}/versions/{versionName}/definitions'].get
  update:
    x-apievangelist-phrasing:
      intent: List definitions for an API version in API Center
      effect: read
      questions:
      - Which specification files are attached to an API version in API Center?
      - Can I see all the definitions registered for one version of my API?
      instructions:
      - text: List the definitions for version {version} of API {api} in workspace {workspace}.
        slots:
          version: path.versionName
          api: path.apiName
          workspace: path.workspaceName
      - text: Show which spec documents API {api} {version} has in API Center workspace {workspace}.
        slots:
          version: path.versionName
          api: path.apiName
          workspace: path.workspaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/workspaces/{workspaceName}/apis/{apiName}/versions/{versionName}/definitions/{definitionName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one API definition in API Center
      effect: read
      questions:
      - How do I read the metadata of a single API definition in API Center?
      - What spec format and version does a registered API definition use?
      instructions:
      - text: Get definition {definition} for API {api} version {version} in workspace {workspace}.
        slots:
          definition: path.definitionName
          api: path.apiName
          version: path.versionName
          workspace: path.workspaceName
      - text: Show the {definition} definition record of {api} {version} in API Center workspace {workspace}.
        slots:
          definition: path.definitionName
          api: path.apiName
          version: path.versionName
          workspace: path.workspaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/workspaces/{workspaceName}/apis/{apiName}/versions/{versionName}/definitions/{definitionName}:exportSpecification'].post
  update:
    x-apievangelist-phrasing:
      intent: Export an API specification from API Center
      effect: read
      questions:
      - Can I download the actual OpenAPI document behind an API Center definition?
      - How do I export the specification file of a registered API definition?
      instructions:
      - text: Export the specification for definition {definition} of API {api} version {version} in workspace {workspace}.
        slots:
          definition: path.definitionName
          api: path.apiName
          version: path.versionName
          workspace: path.workspaceName
      - text: Start a spec export of {api} {version} definition {definition} from API Center workspace {workspace}.
        slots:
          definition: path.definitionName
          api: path.apiName
          version: path.versionName
          workspace: path.workspaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/workspaces/{workspaceName}/apis/{apiName}/versions/{versionName}/definitions/{definitionName}/operations/{operationId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check the status of an API spec export
      effect: read
      questions:
      - Has my API Center specification export finished yet?
      - Where do I find the result of an asynchronous spec export I started?
      instructions:
      - text: Check export operation {operation} for definition {definition} of API {api} {version} in workspace {workspace}.
        slots:
          operation: path.operationId
          definition: path.definitionName
          api: path.apiName
          version: path.versionName
          workspace: path.workspaceName
      - text: Get the status of spec export {operation} on {api} {version} definition {definition} in {workspace}.
        slots:
          operation: path.operationId
          definition: path.definitionName
          api: path.apiName
          version: path.versionName
          workspace: path.workspaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/workspaces/{workspaceName}/environments'].get
  update:
    x-apievangelist-phrasing:
      intent: List environments in an API Center workspace
      effect: read
      questions:
      - Which runtime environments, like staging and production, are defined in my API Center workspace?
      - Can I page through the environments recorded in an API Center workspace?
      instructions:
      - text: List the environments defined in API Center workspace {workspace}.
        slots:
          workspace: path.workspaceName
      - text: Show the first {top} environments in API Center workspace {workspace}, skipping {skip}.
        slots:
          top: query.top
          skip: query.skip
          workspace: path.workspaceName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/workspaces/{workspaceName}/environments/{environmentName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an environment in an API Center workspace
      effect: read
      questions:
      - How do I look up one environment registered in API Center by its name?
      - What details does API Center hold about a single deployment environment?
      instructions:
      - text: Get environment {environment} from API Center workspace {workspace}.
        slots:
          environment: path.environmentName
          workspace: path.workspaceName
      - text: Show the details of API Center environment {environment} in workspace {workspace}.
        slots:
          environment: path.environmentName
          workspace: path.workspaceName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/workspaces/{workspaceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve a workspace by name in a resource group
      effect: read
      questions:
      - How do I fetch a workspace resource by name from a resource group without naming its service provider?
      - What does the generic workspace lookup by name return?
      instructions:
      - text: Retrieve workspace {workspace} using the generic resource-group workspace lookup.
        slots:
          workspace: path.workspaceName
      - text: Look up the resource-group workspace named {workspace} directly.
        slots:
          workspace: path.workspaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/workspaces/{workspaceId}/query'].get
  update:
    x-apievangelist-phrasing:
      intent: Run a Log Analytics query via the query string
      effect: read
      questions:
      - How do I run a KQL query against my Log Analytics workspace with a simple GET?
      - Can I limit a Log Analytics query to a timespan like the last day?
      instructions:
      - text: Run the query {query} against Log Analytics workspace {workspace} using a GET request.
        slots:
          query: query.query
          workspace: path.workspaceId
      - text: Query Log Analytics workspace {workspace} with {query} over timespan {timespan}.
        slots:
          workspace: path.workspaceId
          query: query.query
          timespan: query.timespan
      method: generated
      generated: '2026-09-26'
- target: $.paths['/workspaces/{workspaceId}/query'].post
  update:
    x-apievangelist-phrasing:
      intent: Run a Log Analytics query with a request body
      effect: read
      questions:
      - Can I send a long Kusto query to Log Analytics in a POST body instead of the URL?
      - How do I ask for extra statistics or a longer wait when posting a Log Analytics query?
      instructions:
      - text: Post the analytics query {body} to Log Analytics workspace {workspace}.
        slots:
          body: body.body
          workspace: path.workspaceId
      - text: Execute query body {body} on workspace {workspace} with Prefer header {prefer}.
        slots:
          body: body.body
          workspace: path.workspaceId
          prefer: header.Prefer
      method: generated
      generated: '2026-09-26'
- target: $.paths['/workspaces/{workspaceId}/metadata'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Log Analytics workspace's schema metadata
      effect: read
      questions:
      - What tables, functions and categories exist in my Log Analytics workspace?
      - How can I discover the schema of a Log Analytics workspace before querying it?
      instructions:
      - text: Get the schema metadata for Log Analytics workspace {workspace}.
        slots:
          workspace: path.workspaceId
      - text: Fetch the tables and functions metadata of workspace {workspace} with a GET.
        slots:
          workspace: path.workspaceId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/workspaces/{workspaceId}/metadata'].post
  update:
    x-apievangelist-phrasing:
      intent: Get Log Analytics metadata using POST
      effect: read
      questions:
      - Is there a POST variant for reading Log Analytics workspace metadata?
      - Can I retrieve workspace schema and function metadata through a POST call?
      instructions:
      - text: Retrieve metadata for Log Analytics workspace {workspace} via the POST endpoint.
        slots:
          workspace: path.workspaceId
      - text: Use POST to read the schema, functions and categories of workspace {workspace}.
        slots:
          workspace: path.workspaceId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.MachineLearningServices/workspaces'].get
  update:
    x-apievangelist-phrasing:
      intent: List Azure Machine Learning workspaces in a subscription
      effect: read
      questions:
      - Which Azure Machine Learning workspaces exist across my whole subscription?
      - Can I filter subscription-wide Machine Learning workspaces by kind, such as hubs or projects?
      instructions:
      - text: List every Azure Machine Learning workspace in my subscription.
      - text: List Azure Machine Learning workspaces of kind {kind} across the subscription.
        slots:
          kind: query.kind
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces'].get
  update:
    x-apievangelist-phrasing:
      intent: List Azure Machine Learning workspaces in a resource group
      effect: read
      questions:
      - What Azure Machine Learning workspaces are in one resource group?
      - Can I narrow a resource group's Machine Learning workspaces by AI capabilities?
      instructions:
      - text: List the Azure Machine Learning workspaces in my resource group.
      - text: Show resource-group Azure Machine Learning workspaces of kind {kind}.
        slots:
          kind: query.kind
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Azure Machine Learning workspace
      effect: read
      questions:
      - How do I read the properties of an Azure Machine Learning workspace?
      - What storage, key vault and settings is my Azure ML workspace using?
      instructions:
      - text: Get Azure Machine Learning workspace {workspace}.
        slots:
          workspace: path.workspaceName
      - text: Show the properties of Azure ML workspace {workspace}.
        slots:
          workspace: path.workspaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update an Azure Machine Learning workspace
      effect: write
      questions:
      - How do I provision a new Azure Machine Learning workspace?
      - Can I choose the region and SKU when creating an Azure ML workspace?
      instructions:
      - text: Create Azure Machine Learning workspace {workspace} in {location} with properties {properties}.
        slots:
          workspace: path.workspaceName
          location: requestBody.location
          properties: requestBody.properties
      - text: Create or replace Azure ML workspace {workspace} as kind {kind} with properties {properties}.
        slots:
          workspace: path.workspaceName
          kind: requestBody.kind
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an Azure Machine Learning workspace
      effect: destructive
      questions:
      - How do I remove an Azure Machine Learning workspace?
      - Can I permanently purge an Azure ML workspace instead of soft-deleting it?
      instructions:
      - text: Delete Azure Machine Learning workspace {workspace}.
        slots:
          workspace: path.workspaceName
      - text: Delete Azure ML workspace {workspace} with force purge set to {purge}.
        slots:
          workspace: path.workspaceName
          purge: query.forceToPurge
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an Azure Machine Learning workspace
      effect: write
      questions:
      - How do I change the SKU or tags on an existing Azure Machine Learning workspace?
      - Can I patch just a few properties of my Azure ML workspace?
      instructions:
      - text: Update tags on Azure Machine Learning workspace {workspace} to {tags}.
        slots:
          workspace: path.workspaceName
          tags: requestBody.tags
      - text: Change the SKU of existing Azure ML workspace {workspace} to {sku}.
        slots:
          workspace: path.workspaceName
          sku: requestBody.sku
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/features'].get
  update:
    x-apievangelist-phrasing:
      intent: List enabled features of a Machine Learning workspace
      effect: read
      questions:
      - Which features are turned on for my Azure Machine Learning workspace?
      - Can I check what capabilities are enabled in an Azure ML workspace?
      instructions:
      - text: List the enabled features of Azure Machine Learning workspace {workspaceName}.
        slots:
          workspaceName: path.workspaceName
      - text: Show which feature flags are active on Azure ML workspace {workspaceName}.
        slots:
          workspaceName: path.workspaceName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Databricks/workspaces/{workspaceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Azure Databricks workspace
      effect: read
      questions:
      - How do I look up an Azure Databricks workspace and its settings?
      - What managed resource group does my Databricks workspace use?
      instructions:
      - text: Get Azure Databricks workspace {workspace} in resource group {group}.
        slots:
          workspace: path.workspaceName
          group: path.resourceGroupName
      - text: Show the configuration of Databricks workspace {workspace} in {group} of subscription {sub}.
        slots:
          workspace: path.workspaceName
          group: path.resourceGroupName
          sub: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Databricks/workspaces/{workspaceName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create an Azure Databricks workspace
      effect: write
      questions:
      - How do I deploy a new Azure Databricks workspace?
      - Can I pick the pricing tier when creating a Databricks workspace?
      instructions:
      - text: Create Azure Databricks workspace {workspace} in resource group {group} in {location} with properties {properties}.
        slots:
          workspace: path.workspaceName
          group: path.resourceGroupName
          location: requestBody.location
          properties: requestBody.properties
      - text: Create Databricks workspace {workspace} in subscription {sub}, group {group}, at {location} using properties {properties}.
        slots:
          workspace: path.workspaceName
          group: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Databricks/workspaces/{workspaceName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an Azure Databricks workspace
      effect: destructive
      questions:
      - How do I tear down an Azure Databricks workspace?
      - Can I keep Unity Catalog data when deleting a Databricks workspace?
      instructions:
      - text: Delete Azure Databricks workspace {workspace} in resource group {group}.
        slots:
          workspace: path.workspaceName
          group: path.resourceGroupName
      - text: 'Delete Databricks workspace {workspace} in {group} of subscription {sub}, retaining Unity Catalog data: {retain}.'
        slots:
          workspace: path.workspaceName
          group: path.resourceGroupName
          sub: path.subscriptionId
          retain: query.retainUcData
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Databricks/workspaces/{workspaceName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update tags on an Azure Databricks workspace
      effect: write
      questions:
      - How do I change the tags on a Databricks workspace?
      - Can I retag an existing Databricks workspace without redeploying it?
      instructions:
      - text: Set tags {tags} on Azure Databricks workspace {workspace} in {group}.
        slots:
          tags: requestBody.tags
          workspace: path.workspaceName
          group: path.resourceGroupName
      - text: Update Databricks workspace {workspace} in subscription {sub}, resource group {group}, with new tags {tags}.
        slots:
          workspace: path.workspaceName
          group: path.resourceGroupName
          sub: path.subscriptionId
          tags: requestBody.tags
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Databricks/workspaces'].get
  update:
    x-apievangelist-phrasing:
      intent: List Azure Databricks workspaces in a resource group
      effect: read
      questions:
      - Which Databricks workspaces live in a given resource group?
      - Can I inventory the Databricks workspaces in one resource group?
      instructions:
      - text: List the Azure Databricks workspaces in resource group {group}.
        slots:
          group: path.resourceGroupName
      - text: Show all Databricks workspaces under {group} in subscription {sub}.
        slots:
          group: path.resourceGroupName
          sub: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Databricks/workspaces'].get
  update:
    x-apievangelist-phrasing:
      intent: List Azure Databricks workspaces in a subscription
      effect: read
      questions:
      - What Databricks workspaces do I have across my entire subscription?
      - Is there a subscription-wide inventory of Azure Databricks workspaces?
      instructions:
      - text: List every Azure Databricks workspace in my subscription.
      - text: Show all Databricks workspaces across subscription {sub}.
        slots:
          sub: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.IoTFirmwareDefense/workspaces'].get
  update:
    x-apievangelist-phrasing:
      intent: List firmware analysis workspaces in a subscription
      effect: read
      questions:
      - Which firmware analysis workspaces exist in my subscription?
      - Can I see all IoT firmware analysis workspaces subscription-wide?
      instructions:
      - text: List every firmware analysis workspace in my subscription.
      - text: Show all IoT firmware defense workspaces across the subscription.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTFirmwareDefense/workspaces'].get
  update:
    x-apievangelist-phrasing:
      intent: List firmware analysis workspaces in a resource group
      effect: read
      questions:
      - What firmware analysis workspaces are in my resource group?
      - Can I list IoT firmware analysis workspaces for just one resource group?
      instructions:
      - text: List the firmware analysis workspaces in my resource group.
      - text: Show the resource group's IoT firmware defense workspaces.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTFirmwareDefense/workspaces/{workspaceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a firmware analysis workspace
      effect: read
      questions:
      - How do I read the details of a firmware analysis workspace?
      - What is the provisioning state of my IoT firmware analysis workspace?
      instructions:
      - text: Get firmware analysis workspace {workspaceName}.
        slots:
          workspaceName: path.workspaceName
      - text: Show the details and provisioning state of IoT firmware defense workspace {workspaceName}.
        slots:
          workspaceName: path.workspaceName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTFirmwareDefense/workspaces/{workspaceName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a firmware analysis workspace
      effect: write
      questions:
      - How do I set up a workspace for analyzing IoT device firmware?
      - Can I create a firmware analysis workspace from a full resource definition?
      instructions:
      - text: Create firmware analysis workspace {workspaceName} from definition {workspace}.
        slots:
          workspaceName: path.workspaceName
          workspace: body.workspace
      - text: Create or replace the IoT firmware defense workspace using {workspace}.
        slots:
          workspace: body.workspace
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTFirmwareDefense/workspaces/{workspaceName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a firmware analysis workspace
      effect: destructive
      questions:
      - How do I remove a firmware analysis workspace I no longer need?
      - Does deleting an IoT firmware defense workspace remove it for good?
      instructions:
      - text: Delete firmware analysis workspace {workspaceName}.
        slots:
          workspaceName: path.workspaceName
      - text: Remove IoT firmware defense workspace {workspaceName} permanently.
        slots:
          workspaceName: path.workspaceName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTFirmwareDefense/workspaces/{workspaceName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a firmware analysis workspace
      effect: write
      questions:
      - How do I modify an existing firmware analysis workspace?
      - Can I patch settings on an IoT firmware analysis workspace?
      instructions:
      - text: Update firmware analysis workspace {workspaceName} with changes {workspace}.
        slots:
          workspaceName: path.workspaceName
          workspace: body.workspace
      - text: Patch the existing IoT firmware defense workspace using {workspace}.
        slots:
          workspace: body.workspace
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTFirmwareDefense/workspaces/{workspaceName}/generateUploadUrl'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate a firmware upload URL
      effect: write
      questions:
      - How do I get a URL to upload a firmware image for analysis?
      - Where do I upload firmware files into an analysis workspace?
      instructions:
      - text: Generate an upload URL for firmware file {request}.
        slots:
          request: body.generateUploadUrl
      - text: Get a firmware upload link in analysis workspace {workspaceName} for {request}.
        slots:
          workspaceName: path.workspaceName
          request: body.generateUploadUrl
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearning/workspaces/{workspaceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Machine Learning Studio (classic) workspace
      effect: read
      questions:
      - How do I read a Machine Learning Studio (classic) workspace's properties?
      - What owner and storage account does my classic ML workspace use?
      instructions:
      - text: Get classic Machine Learning Studio workspace {workspace} in {group}.
        slots:
          workspace: path.workspaceName
          group: path.resourceGroupName
      - text: Show the properties of classic ML Studio workspace {workspace} in resource group {group} of subscription {sub}.
        slots:
          workspace: path.workspaceName
          group: path.resourceGroupName
          sub: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearning/workspaces/{workspaceName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a classic Machine Learning Studio workspace
      effect: write
      questions:
      - How do I create a Machine Learning Studio (classic) workspace?
      - Can I set the region and tags on a classic ML Studio workspace when creating it?
      instructions:
      - text: Create classic Machine Learning Studio workspace {workspace} in {group} at {location}.
        slots:
          workspace: path.workspaceName
          group: path.resourceGroupName
          location: requestBody.location
      - text: Create or replace classic ML Studio workspace {workspace} in subscription {sub}, group {group}, at {location}.
        slots:
          workspace: path.workspaceName
          group: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearning/workspaces/{workspaceName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a classic Machine Learning Studio workspace
      effect: destructive
      questions:
      - How do I delete a Machine Learning Studio (classic) workspace?
      - Can I remove an old classic ML Studio workspace from a resource group?
      instructions:
      - text: Delete classic Machine Learning Studio workspace {workspace} in {group}.
        slots:
          workspace: path.workspaceName
          group: path.resourceGroupName
      - text: Remove classic ML Studio workspace {workspace} from resource group {group} in subscription {sub}.
        slots:
          workspace: path.workspaceName
          group: path.resourceGroupName
          sub: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearning/workspaces/{workspaceName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a classic Machine Learning Studio workspace
      effect: write
      questions:
      - How do I change tags on a Machine Learning Studio (classic) workspace?
      - Can I patch properties of an existing classic ML Studio workspace?
      instructions:
      - text: Update tags on classic Machine Learning Studio workspace {workspace} in {group} to {tags}.
        slots:
          workspace: path.workspaceName
          group: path.resourceGroupName
          tags: requestBody.tags
      - text: Patch classic ML Studio workspace {workspace} in {group}, subscription {sub}, with properties {properties}.
        slots:
          workspace: path.workspaceName
          group: path.resourceGroupName
          sub: path.subscriptionId
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearning/workspaces/{workspaceName}/resyncStorageKeys'].post
  update:
    x-apievangelist-phrasing:
      intent: Resync storage keys for a classic ML workspace
      effect: write
      questions:
      - I rotated my storage account keys, how do I resync them into a classic ML Studio workspace?
      - Can a Machine Learning Studio (classic) workspace pick up new storage keys?
      instructions:
      - text: Resync the storage keys for classic ML Studio workspace {workspace} in {group}.
        slots:
          workspace: path.workspaceName
          group: path.resourceGroupName
      - text: Refresh storage account keys on classic Machine Learning workspace {workspace} in {group}, subscription {sub}.
        slots:
          workspace: path.workspaceName
          group: path.resourceGroupName
          sub: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearning/workspaces/{workspaceName}/listWorkspaceKeys'].post
  update:
    x-apievangelist-phrasing:
      intent: List authorization keys of a classic ML workspace
      effect: read
      questions:
      - Where do I find the primary and secondary keys for a classic ML Studio workspace?
      - Can I retrieve the authorization tokens of a Machine Learning Studio (classic) workspace?
      instructions:
      - text: List the authorization keys of classic ML Studio workspace {workspace} in {group}.
        slots:
          workspace: path.workspaceName
          group: path.resourceGroupName
      - text: Show the workspace keys for classic Machine Learning workspace {workspace} in {group}, subscription {sub}.
        slots:
          workspace: path.workspaceName
          group: path.resourceGroupName
          sub: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearning/workspaces'].get
  update:
    x-apievangelist-phrasing:
      intent: List classic ML Studio workspaces in a resource group
      effect: read
      questions:
      - Which Machine Learning Studio (classic) workspaces are in a resource group?
      - Can I inventory classic ML Studio workspaces for one resource group?
      instructions:
      - text: List the classic Machine Learning Studio workspaces in resource group {group}.
        slots:
          group: path.resourceGroupName
      - text: Show all classic ML Studio workspaces under {group} in subscription {sub}.
        slots:
          group: path.resourceGroupName
          sub: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.MachineLearning/workspaces'].get
  update:
    x-apievangelist-phrasing:
      intent: List classic ML Studio workspaces in a subscription
      effect: read
      questions:
      - What Machine Learning Studio (classic) workspaces remain in my subscription?
      - Is there a subscription-wide list of classic ML Studio workspaces?
      instructions:
      - text: List every classic Machine Learning Studio workspace in my subscription.
      - text: Show all classic ML Studio workspaces across subscription {sub}.
        slots:
          sub: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/workspaces/{workspaceId}/threatintelligenceindicators:upload'].post
  update:
    x-apievangelist-phrasing:
      intent: Upload threat intelligence indicators to Sentinel
      effect: write
      questions:
      - How do I push threat intelligence indicators into a Microsoft Sentinel workspace?
      - Can I tag uploaded threat indicators with the source system they came from?
      instructions:
      - text: Upload threat indicators {indicators} to Sentinel workspace {workspace}.
        slots:
          indicators: requestBody.indicators
          workspace: path.workspaceId
      - text: Upload indicators {indicators} from source system {source} into workspace {workspace}.
        slots:
          indicators: requestBody.indicators
          source: requestBody.sourcesystem
          workspace: path.workspaceId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Easm/workspaces'].get
  update:
    x-apievangelist-phrasing:
      intent: List Defender EASM workspaces in a subscription
      effect: read
      questions:
      - Which external attack surface management workspaces exist in my subscription?
      - Can I see every Defender EASM workspace subscription-wide?
      instructions:
      - text: List every Defender EASM workspace in my subscription.
      - text: Show all external attack surface workspaces across the subscription.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Easm/workspaces'].get
  update:
    x-apievangelist-phrasing:
      intent: List Defender EASM workspaces in a resource group
      effect: read
      questions:
      - What Defender EASM workspaces are in my resource group?
      - Can I list attack surface management workspaces for one resource group only?
      instructions:
      - text: List the Defender EASM workspaces in my resource group.
      - text: Show the resource group's external attack surface management workspaces.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Easm/workspaces/{workspaceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Defender EASM workspace
      effect: read
      questions:
      - How do I look up a Defender EASM workspace by name?
      - What data-plane endpoint does my attack surface workspace expose?
      instructions:
      - text: Get Defender EASM workspace {workspace}.
        slots:
          workspace: path.workspaceName
      - text: Show the details of external attack surface workspace {workspace}.
        slots:
          workspace: path.workspaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Easm/workspaces/{workspaceName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a Defender EASM workspace
      effect: write
      questions:
      - How do I create a workspace for external attack surface management?
      - Can I set properties when provisioning a Defender EASM workspace?
      instructions:
      - text: Create Defender EASM workspace {workspace}.
        slots:
          workspace: path.workspaceName
      - text: Create or replace attack surface workspace {workspace} with properties {properties}.
        slots:
          workspace: path.workspaceName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Easm/workspaces/{workspaceName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Defender EASM workspace
      effect: destructive
      questions:
      - How do I delete an external attack surface management workspace?
      - Can I remove a Defender EASM workspace I no longer monitor with?
      instructions:
      - text: Delete Defender EASM workspace {workspace}.
        slots:
          workspace: path.workspaceName
      - text: Remove external attack surface workspace {workspace}.
        slots:
          workspace: path.workspaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Easm/workspaces/{workspaceName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update tags on a Defender EASM workspace
      effect: write
      questions:
      - How do I retag a Defender EASM workspace?
      - Can I change tags on an attack surface management workspace after creation?
      instructions:
      - text: Set tags {tags} on Defender EASM workspace {workspace}.
        slots:
          tags: requestBody.tags
          workspace: path.workspaceName
      - text: Update attack surface workspace {workspace} with tags {tags}.
        slots:
          workspace: path.workspaceName
          tags: requestBody.tags
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningExperimentation/accounts/{accountName}/workspaces/{workspaceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a workspace in an ML Experimentation team account
      effect: read
      questions:
      - How do I read a workspace that belongs to a Machine Learning Experimentation team account?
      - What properties does a team account's ML workspace have?
      instructions:
      - text: Get workspace {workspace} in ML Experimentation account {account} in {group}.
        slots:
          workspace: path.workspaceName
          account: path.accountName
          group: path.resourceGroupName
      - text: Show team account {account} workspace {workspace} from resource group {group} in subscription {sub}.
        slots:
          workspace: path.workspaceName
          account: path.accountName
          group: path.resourceGroupName
          sub: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningExperimentation/accounts/{accountName}/workspaces/{workspaceName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a workspace in an ML Experimentation team account
      effect: write
      questions:
      - How do I add a workspace to a Machine Learning Experimentation team account?
      - Can I choose a location for a new team account ML workspace?
      instructions:
      - text: Create workspace {workspace} under ML Experimentation account {account} in {group} at {location}.
        slots:
          workspace: path.workspaceName
          account: path.accountName
          group: path.resourceGroupName
          location: requestBody.location
      - text: Create or replace team account {account} workspace {workspace} in subscription {sub}, group {group}, at {location}.
        slots:
          workspace: path.workspaceName
          account: path.accountName
          group: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningExperimentation/accounts/{accountName}/workspaces/{workspaceName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a workspace from an ML Experimentation account
      effect: destructive
      questions:
      - How do I remove a workspace from a Machine Learning Experimentation team account?
      - Can I delete one workspace without deleting the whole team account?
      instructions:
      - text: Delete workspace {workspace} from ML Experimentation account {account} in {group}.
        slots:
          workspace: path.workspaceName
          account: path.accountName
          group: path.resourceGroupName
      - text: Remove team account {account} workspace {workspace} in resource group {group}, subscription {sub}.
        slots:
          workspace: path.workspaceName
          account: path.accountName
          group: path.resourceGroupName
          sub: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningExperimentation/accounts/{accountName}/workspaces/{workspaceName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a workspace in an ML Experimentation account
      effect: write
      questions:
      - How do I change tags or properties on a team account ML workspace?
      - Can I patch a workspace inside a Machine Learning Experimentation account?
      instructions:
      - text: Update tags on workspace {workspace} in ML Experimentation account {account} in {group} to {tags}.
        slots:
          workspace: path.workspaceName
          account: path.accountName
          group: path.resourceGroupName
          tags: requestBody.tags
      - text: Patch team account {account} workspace {workspace} in {group}, subscription {sub}, with properties {properties}.
        slots:
          workspace: path.workspaceName
          account: path.accountName
          group: path.resourceGroupName
          sub: path.subscriptionId
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningExperimentation/accounts/{accountName}/workspaces'].get
  update:
    x-apievangelist-phrasing:
      intent: List workspaces in an ML Experimentation team account
      effect: read
      questions:
      - Which workspaces belong to my Machine Learning Experimentation team account?
      - Can I list every workspace under one team account?
      instructions:
      - text: List the workspaces in ML Experimentation account {account} in {group}.
        slots:
          account: path.accountName
          group: path.resourceGroupName
      - text: Show all workspaces under team account {account} in resource group {group}, subscription {sub}.
        slots:
          account: path.accountName
          group: path.resourceGroupName
          sub: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.PowerBI/workspaceCollections/{workspaceCollectionName}/workspaces'].get
  update:
    x-apievangelist-phrasing:
      intent: List Power BI workspaces in a workspace collection
      effect: read
      questions:
      - Which Power BI workspaces are in my Power BI Embedded workspace collection?
      - Can I list the workspaces inside one Power BI workspace collection?
      instructions:
      - text: List the Power BI workspaces in collection {collection} in {group}.
        slots:
          collection: path.workspaceCollectionName
          group: path.resourceGroupName
      - text: Show all workspaces in Power BI workspace collection {collection} under resource group {group} in subscription {sub}.
        slots:
          collection: path.workspaceCollectionName
          group: path.resourceGroupName
          sub: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Synapse/workspaces'].get
  update:
    x-apievangelist-phrasing:
      intent: List Synapse workspaces in a resource group
      effect: read
      questions:
      - Which Azure Synapse Analytics workspaces are in my resource group?
      - Can I list Synapse workspaces for a single resource group?
      instructions:
      - text: List the Synapse workspaces in my resource group.
      - text: Show the resource group's Azure Synapse Analytics workspaces.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Synapse/workspaces/{workspaceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Azure Synapse workspace
      effect: read
      questions:
      - How do I read the configuration of an Azure Synapse workspace?
      - What default data lake and managed identity does my Synapse workspace use?
      instructions:
      - text: Get Synapse workspace {workspace}.
        slots:
          workspace: path.workspaceName
      - text: Show the configuration of Azure Synapse Analytics workspace {workspace}.
        slots:
          workspace: path.workspaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Synapse/workspaces/{workspaceName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update an Azure Synapse workspace
      effect: write
      questions:
      - How do I provision an Azure Synapse Analytics workspace?
      - Can I assign a managed identity when creating a Synapse workspace?
      instructions:
      - text: Create Synapse workspace {workspace} with properties {properties}.
        slots:
          workspace: path.workspaceName
          properties: requestBody.properties
      - text: Create or replace Azure Synapse workspace {workspace} using identity {identity}.
        slots:
          workspace: path.workspaceName
          identity: requestBody.identity
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Synapse/workspaces/{workspaceName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an Azure Synapse workspace
      effect: destructive
      questions:
      - How do I delete an Azure Synapse Analytics workspace?
      - Can I tear down a Synapse workspace I no longer use?
      instructions:
      - text: Delete Synapse workspace {workspace}.
        slots:
          workspace: path.workspaceName
      - text: Remove Azure Synapse Analytics workspace {workspace}.
        slots:
          workspace: path.workspaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Synapse/workspaces/{workspaceName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an Azure Synapse workspace
      effect: write
      questions:
      - How do I change tags or identity on an existing Synapse workspace?
      - Can I patch properties on an Azure Synapse Analytics workspace?
      instructions:
      - text: Update tags on Synapse workspace {workspace} to {tags}.
        slots:
          workspace: path.workspaceName
          tags: requestBody.tags
      - text: Patch existing Azure Synapse workspace {workspace} with properties {properties}.
        slots:
          workspace: path.workspaceName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Synapse/workspaces'].get
  update:
    x-apievangelist-phrasing:
      intent: List Azure Synapse workspaces in a subscription
      effect: read
      questions:
      - What Synapse Analytics workspaces do I have across my subscription?
      - Is there a subscription-wide list of Azure Synapse workspaces?
      instructions:
      - text: List every Synapse workspace in my subscription.
      - text: Show all Azure Synapse Analytics workspaces across the subscription.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Synapse/workspaces/{workspaceName}/administrators/activeDirectory'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Synapse workspace's Entra ID admin
      effect: read
      questions:
      - Who is the Active Directory administrator on my Synapse workspace?
      - How do I check the Microsoft Entra admin set on an Azure Synapse workspace?
      instructions:
      - text: Get the Active Directory admin of Synapse workspace {workspace}.
        slots:
          workspace: path.workspaceName
      - text: Show who is workspace AD administrator on Synapse {workspace}.
        slots:
          workspace: path.workspaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Synapse/workspaces/{workspaceName}/administrators/activeDirectory'].put
  update:
    x-apievangelist-phrasing:
      intent: Set a Synapse workspace's Entra ID admin
      effect: write
      questions:
      - How do I assign an Active Directory administrator to a Synapse workspace?
      - Can I change the workspace-level AD admin on Azure Synapse?
      instructions:
      - text: Set the Active Directory admin of Synapse workspace {workspace} to {admin}.
        slots:
          workspace: path.workspaceName
          admin: requestBody.properties
      - text: Make {admin} the workspace AD administrator for Synapse {workspace}.
        slots:
          admin: requestBody.properties
          workspace: path.workspaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Synapse/workspaces/{workspaceName}/administrators/activeDirectory'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a Synapse workspace's Entra ID admin
      effect: destructive
      questions:
      - How do I remove the Active Directory administrator from a Synapse workspace?
      - Can I clear the workspace-level AD admin on Azure Synapse?
      instructions:
      - text: Remove the Active Directory admin from Synapse workspace {workspace}.
        slots:
          workspace: path.workspaceName
      - text: Delete the workspace AD administrator setting on Synapse {workspace}.
        slots:
          workspace: path.workspaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Synapse/workspaces/{workspaceName}/sqlAdministrators/activeDirectory'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Synapse workspace's SQL Entra ID admin
      effect: read
      questions:
      - Who is the SQL Active Directory administrator for my Synapse workspace?
      - How do I see the Entra admin for SQL pools in a Synapse workspace?
      instructions:
      - text: Fetch the Entra login that administers SQL pools in Synapse workspace {workspace}.
        slots:
          workspace: path.workspaceName
      - text: Show the SQL AD administrator configured for Synapse {workspace}.
        slots:
          workspace: path.workspaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Synapse/workspaces/{workspaceName}/sqlAdministrators/activeDirectory'].put
  update:
    x-apievangelist-phrasing:
      intent: Set a Synapse workspace's SQL Entra ID admin
      effect: write
      questions:
      - How do I assign a SQL Active Directory admin for a Synapse workspace's SQL pools?
      - Can I change who administers SQL in my Synapse workspace through Entra ID?
      instructions:
      - text: Assign {admin} as the administrator for SQL pools in Synapse workspace {workspace}.
        slots:
          workspace: path.workspaceName
          admin: requestBody.properties
      - text: Make {admin} the SQL AD administrator for Synapse {workspace}.
        slots:
          admin: requestBody.properties
          workspace: path.workspaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Synapse/workspaces/{workspaceName}/sqlAdministrators/activeDirectory'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a Synapse workspace's SQL Entra ID admin
      effect: destructive
      questions:
      - How do I remove the SQL Active Directory admin from a Synapse workspace?
      - Can I clear the SQL Entra administrator on Azure Synapse?
      instructions:
      - text: Clear the SQL pools Entra administrator on Synapse workspace {workspace}.
        slots:
          workspace: path.workspaceName
      - text: Delete the SQL AD administrator setting on Synapse {workspace}.
        slots:
          workspace: path.workspaceName
      method: generated
      generated: '2026-09-26'