# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Densify AWS Analysis API
  version: 1.0.0
extends: openapi/densify-aws-analysis-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: 2
- target: $.paths['/analysis/cloud/aws/{analysisId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an AWS cloud connection and analysis
      effect: destructive
      questions:
      - How do I stop analyzing an AWS account and remove its cloud connection?
      - Can I delete an AWS account's analysis if it never got an analysisId?
      instructions:
      - text: Delete the AWS cloud connection and analysis {analysisId}.
        slots:
          analysisId: path.analysisId
      - text: Stop analyzing the AWS account behind analysis {analysisId} and remove its connection.
        slots:
          analysisId: path.analysisId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/analysis/cloud/aws/{analysisId}/results'].get
  update:
    x-apievangelist-phrasing:
      intent: Get AWS rightsizing recommendations for an analysis
      effect: read
      questions:
      - Which EC2, RDS and ASG instances should I resize in my analyzed AWS account?
      - Can I filter AWS recommendations by region or recommended instance type?
      - Can I get AWS recommendations as a Terraform map keyed by provisioning ID?
      instructions:
      - text: Show the AWS recommendations for analysis {analysisId} in {region}.
        slots:
          analysisId: path.analysisId
          region: query.region
      - text: List AWS systems in analysis {analysisId} with recommendation type {recommendationType}.
        slots:
          analysisId: path.analysisId
          recommendationType: query.recommendationType
      - text: Get the AWS recommendation for resource {resourceId} in analysis {analysisId}.
        slots:
          resourceId: query.resourceId
          analysisId: path.analysisId
      method: generated
      generated: '2026-10-01'