# 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 Endpoint API
  version: 1.0.0
extends: openapi/microsoft-azure-endpoint-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: 17
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/deployments'].get
  update:
    x-apievangelist-phrasing:
      intent: List all deployments in an ML workspace
      effect: read
      questions:
      - How can I see every model deployment across all endpoints in an Azure ML workspace?
      - Can I filter workspace-wide deployments by endpoint type?
      instructions:
      - text: List all deployments in Azure ML workspace {workspaceName}.
        slots:
          workspaceName: path.workspaceName
      - text: Show {endpointType} deployments across workspace {workspaceName}.
        slots:
          endpointType: query.endpointType
          workspaceName: path.workspaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/endpoints'].get
  update:
    x-apievangelist-phrasing:
      intent: List endpoints in an ML workspace
      effect: read
      questions:
      - Which endpoints exist in my Azure Machine Learning workspace?
      - Can I list only one type of endpoint in an ML workspace?
      instructions:
      - text: List the endpoints in ML workspace {workspaceName}.
        slots:
          workspaceName: path.workspaceName
      - text: Show {endpointType} endpoints in workspace {workspaceName}, skipping {skip}.
        slots:
          endpointType: query.endpointType
          workspaceName: path.workspaceName
          skip: query.$skip
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/endpoints/{endpointName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an ML workspace endpoint
      effect: read
      questions:
      - How can I see the details of one endpoint in my ML workspace?
      - What's the configuration of a specific Azure ML endpoint resource?
      instructions:
      - text: Get endpoint {endpointName} in ML workspace {workspaceName}.
        slots:
          endpointName: path.endpointName
          workspaceName: path.workspaceName
      - text: Show the settings of ML endpoint {endpointName} in {workspaceName}.
        slots:
          endpointName: path.endpointName
          workspaceName: path.workspaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/endpoints/{endpointName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update an ML workspace endpoint
      effect: write
      questions:
      - How do I create an endpoint resource in an Azure ML workspace?
      - Can I change the properties of an existing ML endpoint by re-submitting it?
      instructions:
      - text: Create endpoint {endpointName} in ML workspace {workspaceName} with properties {properties}.
        slots:
          endpointName: path.endpointName
          workspaceName: path.workspaceName
          properties: requestBody.properties
      - text: Update ML endpoint {endpointName} in {workspaceName} to use {properties}.
        slots:
          endpointName: path.endpointName
          workspaceName: path.workspaceName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/endpoints/{endpointName}/deployments'].get
  update:
    x-apievangelist-phrasing:
      intent: List deployments under one ML endpoint
      effect: read
      questions:
      - What deployments are running behind a specific ML endpoint?
      - Can I list the model deployments attached to one endpoint only?
      instructions:
      - text: List deployments under endpoint {endpointName} in workspace {workspaceName}.
        slots:
          endpointName: path.endpointName
          workspaceName: path.workspaceName
      - text: Show what is deployed behind ML endpoint {endpointName}.
        slots:
          endpointName: path.endpointName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/endpoints/{endpointName}/deployments/{deploymentName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an ML endpoint deployment by name
      effect: read
      questions:
      - How can I inspect a single deployment on an ML endpoint?
      - What's the configuration of a named deployment behind my endpoint?
      instructions:
      - text: Get deployment {deploymentName} on endpoint {endpointName} in workspace {workspaceName}.
        slots:
          deploymentName: path.deploymentName
          endpointName: path.endpointName
          workspaceName: path.workspaceName
      - text: Show details of ML deployment {deploymentName} under {endpointName}.
        slots:
          deploymentName: path.deploymentName
          endpointName: path.endpointName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/endpoints/{endpointName}/deployments/{deploymentName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update an ML endpoint deployment
      effect: write
      questions:
      - How do I deploy a model to an existing Azure ML endpoint?
      - Can I change an existing deployment's settings on an ML endpoint?
      instructions:
      - text: Create deployment {deploymentName} on endpoint {endpointName} in workspace {workspaceName} with {properties}.
        slots:
          deploymentName: path.deploymentName
          endpointName: path.endpointName
          workspaceName: path.workspaceName
          properties: requestBody.properties
      - text: Update ML deployment {deploymentName} under {endpointName} to properties {properties}.
        slots:
          deploymentName: path.deploymentName
          endpointName: path.endpointName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/endpoints/{endpointName}/deployments/{deploymentName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an ML endpoint deployment
      effect: destructive
      questions:
      - How can I remove a deployment from an Azure ML endpoint?
      - Can I delete one deployment without deleting the whole endpoint?
      instructions:
      - text: Delete deployment {deploymentName} from endpoint {endpointName} in workspace {workspaceName}.
        slots:
          deploymentName: path.deploymentName
          endpointName: path.endpointName
          workspaceName: path.workspaceName
      - text: Remove ML deployment {deploymentName} under {endpointName}.
        slots:
          deploymentName: path.deploymentName
          endpointName: path.endpointName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/endpoints/{endpointName}/listKeys'].post
  update:
    x-apievangelist-phrasing:
      intent: Get the keys for an ML endpoint
      effect: read
      questions:
      - Where do I get the authentication keys for calling an Azure ML endpoint?
      - Can I retrieve an ML endpoint's keys through the API?
      instructions:
      - text: List the keys for endpoint {endpointName} in workspace {workspaceName}.
        slots:
          endpointName: path.endpointName
          workspaceName: path.workspaceName
      - text: Show me the access keys of ML endpoint {endpointName}.
        slots:
          endpointName: path.endpointName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/endpoints/{endpointName}/models'].get
  update:
    x-apievangelist-phrasing:
      intent: List models available on an ML endpoint
      effect: read
      questions:
      - Which models can I use through a particular ML endpoint resource?
      - What models are available under an endpoint in my workspace?
      instructions:
      - text: List models available on endpoint {endpointName} in workspace {workspaceName}.
        slots:
          endpointName: path.endpointName
          workspaceName: path.workspaceName
      - text: Show the models offered by ML endpoint {endpointName}.
        slots:
          endpointName: path.endpointName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/endpoints/{endpointName}/regenerateKey'].post
  update:
    x-apievangelist-phrasing:
      intent: Regenerate an ML endpoint key
      effect: destructive
      questions:
      - How can I rotate the key on an Azure ML endpoint?
      - Will regenerating an ML endpoint key invalidate the old one?
      instructions:
      - text: Regenerate key {keyName} on endpoint {endpointName} in workspace {workspaceName}.
        slots:
          keyName: requestBody.keyName
          endpointName: path.endpointName
          workspaceName: path.workspaceName
      - text: Rotate the keys of ML endpoint {endpointName} in {workspaceName}.
        slots:
          endpointName: path.endpointName
          workspaceName: path.workspaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/endpoints'].get
  update:
    x-apievangelist-phrasing:
      intent: List custom Speech endpoints
      effect: read
      questions:
      - Which custom speech endpoints are deployed on my Speech resource?
      - Can I filter my speech endpoints by project, locale or creation date?
      instructions:
      - text: List the custom speech endpoints on my Speech resource.
      - text: List speech endpoints matching {filter}, {maxpagesize} per page.
        slots:
          filter: query.filter
          maxpagesize: query.maxpagesize
      method: generated
      generated: '2026-10-01'
- target: $.paths['/endpoints/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a custom Speech endpoint
      effect: read
      questions:
      - Which model and project is a particular custom speech endpoint serving?
      - How do I check the status of one speech endpoint by its id?
      instructions:
      - text: Get custom speech endpoint {id}.
        slots:
          id: path.id
      - text: Show the model, project and status of speech endpoint {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/endpoints/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Deploy a custom Speech endpoint
      effect: write
      questions:
      - How do I deploy my custom speech model to an endpoint so I can call it?
      - Which project and model must I name when creating a speech endpoint?
      instructions:
      - text: Create speech endpoint {id} serving model {model} in project {project}.
        slots:
          id: path.id
          model: requestBody.modelId
          project: requestBody.projectId
      - text: Deploy custom speech model {model} from project {project} as endpoint {id} named {name}.
        slots:
          model: requestBody.modelId
          project: requestBody.projectId
          id: path.id
          name: requestBody.displayName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/endpoints/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a custom Speech endpoint
      effect: destructive
      questions:
      - How do I take down a custom speech endpoint I no longer call?
      - Can I permanently delete a speech endpoint rather than suspending it?
      instructions:
      - text: Delete custom speech endpoint {id}.
        slots:
          id: path.id
      - text: Permanently remove speech endpoint {id} from my Speech resource.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/endpoints/{id}:resume'].post
  update:
    x-apievangelist-phrasing:
      intent: Resume a suspended Speech endpoint
      effect: write
      questions:
      - How can I bring a suspended custom speech endpoint back online?
      - Can I resume a Speech endpoint I paused earlier?
      instructions:
      - text: Resume Speech endpoint {id}.
        slots:
          id: path.id
      - text: Bring suspended speech endpoint {id} back into service.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/endpoints/{id}:suspend'].post
  update:
    x-apievangelist-phrasing:
      intent: Suspend a custom Speech endpoint
      effect: write
      questions:
      - Can I pause a custom speech endpoint without deleting it?
      - How do I suspend a Speech endpoint that isn't being used?
      instructions:
      - text: Suspend Speech endpoint {id}.
        slots:
          id: path.id
      - text: Pause custom speech endpoint {id} until I resume it.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'