Densify · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Densify / Kubex Public Cloud Recommendations API

4 actions 4 updates phrasing extends openapi/densify-recommendations-api-openapi.yml

Generated by API Evangelist Written by API Evangelist tooling for Densify's API. It is a proposal applied on top of the contract, not a document Densify publishes.

View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 4

$.info

$.paths['/analysis/aws/{analysisId}/recommendations'].get

$.paths['/analysis/azure/{analysisId}/recommendations'].get

$.paths['/analysis/gcp/{analysisId}/recommendations'].get

OpenAPI Overlay

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Densify / Kubex Public Cloud Recommendations API
  version: 1.0.0
extends: openapi/densify-recommendations-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['/analysis/aws/{analysisId}/recommendations'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve AWS optimization recommendations
      effect: read
      questions:
      - What AWS optimization recommendations came out of my analysis?
      - Can I pull AWS recommendations from the recommendations endpoint by analysis ID?
      instructions:
      - text: Retrieve AWS optimization recommendations for analysis {analysisId}.
        slots:
          analysisId: path.analysisId
      - text: Get the AWS recommendation set for {analysisId}.
        slots:
          analysisId: path.analysisId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/analysis/azure/{analysisId}/recommendations'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve Azure optimization recommendations
      effect: read
      questions:
      - What Azure optimization recommendations did my analysis produce?
      - Can I fetch Azure recommendations by analysis ID?
      instructions:
      - text: Retrieve Azure optimization recommendations for analysis {analysisId}.
        slots:
          analysisId: path.analysisId
      - text: Get the Azure recommendation set for {analysisId}.
        slots:
          analysisId: path.analysisId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/analysis/gcp/{analysisId}/recommendations'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve GCP optimization recommendations
      effect: read
      questions:
      - What GCP optimization recommendations did my analysis return?
      - Can I fetch Google Cloud recommendations by analysis ID?
      instructions:
      - text: Retrieve GCP optimization recommendations for analysis {analysisId}.
        slots:
          analysisId: path.analysisId
      - text: Get the GCP recommendation set for {analysisId}.
        slots:
          analysisId: path.analysisId
      method: generated
      generated: '2026-10-01'