# 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 DevCenter Environment Operations API
  version: 1.0.0
extends: openapi/microsoft-azure-environment-operations-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: 3
- target: $.paths['/projects/{projectName}/users/{userId}/environments/{environmentName}/operations'].get
  update:
    x-apievangelist-phrasing:
      intent: List recent operations on a deployment environment
      effect: read
      questions:
      - What actions have run against my deployment environment in the last 90 days?
      - How far back does the operation history for a dev center environment go?
      instructions:
      - text: List the operations run on deployment environment {environmentName} in the past 90 days.
        slots:
          environmentName: path.environmentName
      - text: Show the action history for user {userId}'s environment {environmentName} in project {projectName}.
        slots:
          userId: path.userId
          environmentName: path.environmentName
          projectName: path.projectName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/projects/{projectName}/users/{userId}/environments/{environmentName}/operations/{operationId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the result of a deployment environment operation
      effect: read
      questions:
      - How do I check whether a specific action on my deployment environment succeeded?
      - Where can I see the outcome of one environment operation by its ID?
      instructions:
      - text: Get the result of operation {operationId} on deployment environment {environmentName}.
        slots:
          operationId: path.operationId
          environmentName: path.environmentName
      - text: Check the status of action {operationId} for user {userId}'s environment {environmentName} in project {projectName}.
        slots:
          operationId: path.operationId
          userId: path.userId
          environmentName: path.environmentName
          projectName: path.projectName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/projects/{projectName}/users/{userId}/environments/{environmentName}/operations/{operationId}/logs'].get
  update:
    x-apievangelist-phrasing:
      intent: Get logs for a deployment environment operation
      effect: read
      questions:
      - Can I read the deployment logs for an action that ran on my dev center environment?
      - Where do I find the log output of a failed environment operation?
      instructions:
      - text: Get the logs for operation {operationId} on deployment environment {environmentName}.
        slots:
          operationId: path.operationId
          environmentName: path.environmentName
      - text: Download the log output of operation {operationId} on user {userId}'s environment {environmentName} in project {projectName}.
        slots:
          operationId: path.operationId
          userId: path.userId
          environmentName: path.environmentName
          projectName: path.projectName
      method: generated
      generated: '2026-10-01'