# 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 Projects API
  version: 1.0.0
extends: openapi/microsoft-azure-projects-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 15
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningExperimentation/accounts/{accountName}/workspaces/{workspaceName}/projects/{projectName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a machine learning experimentation project
      effect: read
      questions:
      - What are the properties of a machine learning project in my experimentation workspace?
      - Can I look up one ML experimentation project by name?
      instructions:
      - text: Get ML project {project} in workspace {workspace} of experimentation account {account}, resource group {rg}, subscription {sub}.
        slots:
          project: path.projectName
          workspace: path.workspaceName
          account: path.accountName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show the machine learning project {project} in workspace {workspace}.
        slots:
          project: path.projectName
          workspace: path.workspaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningExperimentation/accounts/{accountName}/workspaces/{workspaceName}/projects/{projectName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a machine learning project
      effect: write
      questions:
      - How do I create a machine learning project inside an experimentation workspace?
      - Which location must I give when creating an ML experimentation project?
      instructions:
      - text: Create ML project {project} in workspace {workspace}, experimentation account {account}, group {rg}, subscription {sub} in {location}.
        slots:
          project: path.projectName
          workspace: path.workspaceName
          account: path.accountName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
      - text: Create or overwrite machine learning project {project} in workspace {workspace} with properties {props}.
        slots:
          project: path.projectName
          workspace: path.workspaceName
          props: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningExperimentation/accounts/{accountName}/workspaces/{workspaceName}/projects/{projectName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a machine learning experimentation project
      effect: destructive
      questions:
      - Can I delete a machine learning project from my experimentation workspace?
      - What identifies the ML project I want to remove?
      instructions:
      - text: Delete ML project {project} from workspace {workspace} in experimentation account {account}, group {rg}, subscription {sub}.
        slots:
          project: path.projectName
          workspace: path.workspaceName
          account: path.accountName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Remove the machine learning project {project} in workspace {workspace}.
        slots:
          project: path.projectName
          workspace: path.workspaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningExperimentation/accounts/{accountName}/workspaces/{workspaceName}/projects/{projectName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a machine learning project's tags or properties
      effect: write
      questions:
      - Can I change the tags on an existing machine learning experimentation project?
      - What can I patch on an ML project without recreating it?
      instructions:
      - text: Update tags on ML project {project} in workspace {workspace}, account {account}, group {rg}, subscription {sub} to {tags}.
        slots:
          project: path.projectName
          workspace: path.workspaceName
          account: path.accountName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          tags: requestBody.tags
      - text: Patch existing machine learning project {project} with properties {props}.
        slots:
          project: path.projectName
          props: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningExperimentation/accounts/{accountName}/workspaces/{workspaceName}/projects'].get
  update:
    x-apievangelist-phrasing:
      intent: List machine learning projects in a workspace
      effect: read
      questions:
      - Which machine learning projects live in my experimentation workspace?
      - Can I see all ML projects under one workspace at once?
      instructions:
      - text: List ML projects in workspace {workspace} of experimentation account {account}, group {rg}, subscription {sub}.
        slots:
          workspace: path.workspaceName
          account: path.accountName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show every machine learning project under workspace {workspace}.
        slots:
          workspace: path.workspaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageMover/storageMovers/{storageMoverName}/projects'].get
  update:
    x-apievangelist-phrasing:
      intent: List projects in a Storage Mover
      effect: read
      questions:
      - What projects are defined in my Storage Mover?
      - Can I list the job groupings in a Storage Mover resource?
      instructions:
      - text: List the projects in Storage Mover {mover}.
        slots:
          mover: path.storageMoverName
      - text: Show all migration projects under storage mover {mover}.
        slots:
          mover: path.storageMoverName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageMover/storageMovers/{storageMoverName}/projects/{projectName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Storage Mover project
      effect: read
      questions:
      - What does a single Storage Mover project look like?
      - Can I fetch one migration project from my Storage Mover by name?
      instructions:
      - text: Get project {project} in Storage Mover {mover}.
        slots:
          project: path.projectName
          mover: path.storageMoverName
      - text: Show the details of storage mover project {project}.
        slots:
          project: path.projectName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageMover/storageMovers/{storageMoverName}/projects/{projectName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a Storage Mover project
      effect: write
      questions:
      - How do I create a project to group related jobs in Storage Mover?
      - Can I overwrite a Storage Mover project's properties with a full replace?
      instructions:
      - text: Create project {project} in Storage Mover {mover}.
        slots:
          project: path.projectName
          mover: path.storageMoverName
      - text: Create or replace storage mover project {project} in {mover} with properties {props}.
        slots:
          project: path.projectName
          mover: path.storageMoverName
          props: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageMover/storageMovers/{storageMoverName}/projects/{projectName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Storage Mover project
      effect: destructive
      questions:
      - Can I delete a project from my Storage Mover?
      - What is removed when a Storage Mover project is deleted?
      instructions:
      - text: Delete project {project} from Storage Mover {mover}.
        slots:
          project: path.projectName
          mover: path.storageMoverName
      - text: Remove storage mover migration project {project}.
        slots:
          project: path.projectName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageMover/storageMovers/{storageMoverName}/projects/{projectName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a Storage Mover project's properties
      effect: write
      questions:
      - Can I change just one property of a Storage Mover project and leave the rest?
      - What happens to properties I leave out when patching a Storage Mover project?
      instructions:
      - text: Patch project {project} in Storage Mover {mover} with {props}.
        slots:
          project: path.projectName
          mover: path.storageMoverName
          props: requestBody.properties
      - text: Apply partial property changes {props} to storage mover project {project}, keeping other settings.
        slots:
          project: path.projectName
          props: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.visualstudio/account/{rootResourceName}/project'].get
  update:
    x-apievangelist-phrasing:
      intent: List Team Services projects in an account
      effect: read
      questions:
      - Which Visual Studio Team Services projects were created in my Team Services account resource?
      - Can I list the VSTS project resources in a resource group?
      instructions:
      - text: List Team Services projects in account {account}, resource group {rg}, subscription {sub}.
        slots:
          account: path.rootResourceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show every VSTS project resource under Team Services account {account}.
        slots:
          account: path.rootResourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.visualstudio/account/{rootResourceName}/project/{resourceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Team Services project
      effect: read
      questions:
      - What are the details of one Team Services project resource?
      - Can I look up a VSTS project by its resource name?
      instructions:
      - text: Get Team Services project {project} in account {account}, group {rg}, subscription {sub}.
        slots:
          project: path.resourceName
          account: path.rootResourceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show VSTS project {project}.
        slots:
          project: path.resourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.visualstudio/account/{rootResourceName}/project/{resourceName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a Team Services project
      effect: write
      questions:
      - How do I create a Team Services project with Git or TFVC version control?
      - Can I validate a new Team Services project request without creating it?
      instructions:
      - text: Create Team Services project {project} in account {account}, group {rg}, subscription {sub} with properties {props}.
        slots:
          project: path.resourceName
          account: path.rootResourceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          props: requestBody.properties
      - text: Only validate creating VSTS project {project} in {account} (validating={validating}).
        slots:
          project: path.resourceName
          account: path.rootResourceName
          validating: query.validating
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.visualstudio/account/{rootResourceName}/project/{resourceName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update tags on a Team Services project
      effect: write
      questions:
      - Can I change the tags on an existing Team Services project resource?
      - Which fields of a VSTS project resource can be updated after creation?
      instructions:
      - text: Set tags {tags} on Team Services project {project} in account {account}, group {rg}, subscription {sub}.
        slots:
          tags: requestBody.tags
          project: path.resourceName
          account: path.rootResourceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Retag VSTS project {project} with {tags}.
        slots:
          project: path.resourceName
          tags: requestBody.tags
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.visualstudio/account/{rootResourceName}/project/{resourceName}/subContainers/{subContainerName}/status'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a Team Services project creation job
      effect: read
      questions:
      - Has my Team Services project finished being created?
      - Where do I check the status of a VSTS project creation job?
      instructions:
      - text: Get creation job status for project {project} in account {account}, sub-container {container}, group {rg}, subscription {sub}, operation {op}.
        slots:
          project: path.resourceName
          account: path.rootResourceName
          container: path.subContainerName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          op: query.operation
      - text: Check whether job {job} creating VSTS project {project} is done.
        slots:
          job: query.jobId
          project: path.resourceName
      method: generated
      generated: '2026-09-26'