API Evangelist conversational phrasing for Aws Api Gateway Stages API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Aws Api Gateway Stages API
  version: 1.0.0
extends: openapi/aws-api-gateway-stages-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['/restapis/{restapi_id}/stages'].get
  update:
    x-apievangelist-phrasing:
      intent: List a REST API's stages
      effect: read
      questions:
      - What stages, like dev and prod, does my REST API have?
      - How do I see the deployment stages of a REST API?
      instructions:
      - text: List stages of REST API {restapi_id}.
        slots:
          restapi_id: path.restapi_id
      - text: Show the dev and prod stages for REST API {restapi_id}.
        slots:
          restapi_id: path.restapi_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/apis/{api_id}/stages'].get
  update:
    x-apievangelist-phrasing:
      intent: List an HTTP or WebSocket API's stages
      effect: read
      questions:
      - Which stages exist on my HTTP or WebSocket API?
      - Can I see whether auto-deploy is on for my v2 API's stages?
      instructions:
      - text: List stages of HTTP or WebSocket API {api_id}.
        slots:
          api_id: path.api_id
      - text: Show the stages for v2 API {api_id}.
        slots:
          api_id: path.api_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/apis/{api_id}/stages'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a stage for an HTTP or WebSocket API
      effect: write
      questions:
      - How do I add a new stage to my HTTP API?
      - Can a new stage automatically deploy every change?
      instructions:
      - text: Create stage {StageName} on API {api_id}.
        slots:
          StageName: requestBody.StageName
          api_id: path.api_id
      - text: Create stage {StageName} on API {api_id} pointing at deployment {DeploymentId}.
        slots:
          StageName: requestBody.StageName
          api_id: path.api_id
          DeploymentId: requestBody.DeploymentId
      - text: Create auto-deploying stage {StageName} for API {api_id} with AutoDeploy {AutoDeploy}.
        slots:
          StageName: requestBody.StageName
          api_id: path.api_id
          AutoDeploy: requestBody.AutoDeploy
      method: generated
      generated: '2026-10-01'