# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Cloudera Data Warehouse [EXPERIMENTAL] Dw API
  version: 1.0.0
extends: openapi/cloudera-dw-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: 95
- target: $.paths['/api/v1/dw/listClusters'].post
  update:
    x-apievangelist-phrasing:
      intent: List Data Warehouse clusters
      effect: read
      questions:
      - Which Cloudera Data Warehouse clusters are running in my environments?
      - Can I filter my CDW clusters by status or cloud platform?
      instructions:
      - text: List my Data Warehouse clusters.
      - text: Show CDW clusters in environment {environmentCrn} with status {status}.
        slots:
          environmentCrn: requestBody.environmentCrn
          status: requestBody.status
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/describeCluster'].post
  update:
    x-apievangelist-phrasing:
      intent: Get details of one Data Warehouse cluster
      effect: read
      questions:
      - What are the settings and state of a specific CDW cluster?
      - Is my Data Warehouse cluster up and which environment is it in?
      instructions:
      - text: Describe Data Warehouse cluster {clusterId}.
        slots:
          clusterId: requestBody.clusterId
      - text: Show me the full details of CDW cluster {clusterId}.
        slots:
          clusterId: requestBody.clusterId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/createClusterDiagnosticDataJob'].post
  update:
    x-apievangelist-phrasing:
      intent: Collect cluster-level diagnostic logs and metrics
      effect: write
      questions:
      - How do I gather logs and metrics from a whole CDW cluster for a support case?
      - Can a cluster diagnostic bundle be limited to a time window and tagged with a case number?
      instructions:
      - text: Start a cluster diagnostic job for {clusterId} sending the bundle to {destination}.
        slots:
          clusterId: requestBody.clusterId
          destination: requestBody.destination
      - text: Collect cluster {clusterId} diagnostics from {startTime} to {endTime} for support case {caseNumber}, uploading to {destination}.
        slots:
          clusterId: requestBody.clusterId
          startTime: requestBody.startTime
          endTime: requestBody.endTime
          caseNumber: requestBody.caseNumber
          destination: requestBody.destination
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/listClusterDiagnosticDataJobs'].post
  update:
    x-apievangelist-phrasing:
      intent: List diagnostic jobs for a cluster
      effect: read
      questions:
      - What cluster-level diagnostic bundles have been collected for my CDW cluster?
      - Can I see only the cluster diagnostic jobs that are still running?
      instructions:
      - text: List the cluster-level diagnostic jobs for {clusterId}.
        slots:
          clusterId: requestBody.clusterId
      - text: Show cluster {clusterId} diagnostic jobs with status {status}.
        slots:
          clusterId: requestBody.clusterId
          status: requestBody.status
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/describeClusterDiagnosticDataJob'].post
  update:
    x-apievangelist-phrasing:
      intent: Get one cluster diagnostic job
      effect: read
      questions:
      - Has the cluster diagnostic bundle I requested finished?
      - What metadata does a single cluster-level diagnostic job carry?
      instructions:
      - text: Describe cluster diagnostic job {jobId} on cluster {clusterId}.
        slots:
          jobId: requestBody.jobId
          clusterId: requestBody.clusterId
      - text: Check the progress of cluster-wide diagnostics job {jobId} for {clusterId}.
        slots:
          jobId: requestBody.jobId
          clusterId: requestBody.clusterId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/deleteClusterDiagnosticDataJob'].post
  update:
    x-apievangelist-phrasing:
      intent: Delete a cluster diagnostic job
      effect: destructive
      questions:
      - Can I delete a cluster-level diagnostic job even while it's still running?
      - How do I remove an old cluster diagnostic bundle job?
      instructions:
      - text: Delete cluster diagnostic job {jobId} on cluster {clusterId}.
        slots:
          jobId: requestBody.jobId
          clusterId: requestBody.clusterId
      - text: Cancel and remove the cluster-wide diagnostics job {jobId} from {clusterId}.
        slots:
          jobId: requestBody.jobId
          clusterId: requestBody.clusterId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/describeKubeconfig'].post
  update:
    x-apievangelist-phrasing:
      intent: Get the kubeconfig for a cluster
      effect: read
      questions:
      - How can I get kubectl access to the Kubernetes behind my CDW cluster?
      - Where do I download the kubeconfig file for a Data Warehouse cluster?
      instructions:
      - text: Get the kubeconfig for cluster {clusterId}.
        slots:
          clusterId: requestBody.clusterId
      - text: Give me a kubeconfig so I can run kubectl against {clusterId}.
        slots:
          clusterId: requestBody.clusterId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/describeAllowedInstanceTypes'].post
  update:
    x-apievangelist-phrasing:
      intent: List allowed compute instance types
      effect: read
      questions:
      - Which compute instance types can a CDW cluster use on AWS and Azure?
      - What's the default instance type for Data Warehouse compute?
      instructions:
      - text: List the allowed instance types for Data Warehouse clusters.
      - text: Show the default and permitted compute node sizes for AWS and Azure.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/describeServerSetting'].post
  update:
    x-apievangelist-phrasing:
      intent: Show the DWX server settings
      effect: read
      questions:
      - What server settings are currently enabled in my DWX Private Cloud?
      - Which Data Warehouse server feature toggles are on right now?
      instructions:
      - text: Show the current DWX server settings.
      - text: List which DWX server toggles are switched on.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/updateServerSetting'].post
  update:
    x-apievangelist-phrasing:
      intent: Turn DWX server settings on or off
      effect: write
      questions:
      - How do I enable or disable a DWX server setting?
      - Do some server setting changes require recreating a Virtual Warehouse?
      instructions:
      - text: Update the DWX server settings to {settings}.
        slots:
          settings: requestBody.settings
      - text: 'Switch these DWX server toggles: {settings}.'
        slots:
          settings: requestBody.settings
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/resetServerSettings'].post
  update:
    x-apievangelist-phrasing:
      intent: Reset DWX server settings to defaults
      effect: destructive
      questions:
      - Can I put all DWX server settings back to their default values?
      - What happens to my custom server toggles if I reset them?
      instructions:
      - text: Reset the DWX server settings to their defaults.
      - text: Undo all my DWX server setting changes and restore the factory values.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/listEvents'].post
  update:
    x-apievangelist-phrasing:
      intent: List events for an operation or service
      effect: read
      questions:
      - What events happened during a particular Data Warehouse operation?
      - Can I see the event history for a Data Visualization app or cluster by its service ID?
      instructions:
      - text: List events for operation {operationId}.
        slots:
          operationId: requestBody.operationId
      - text: Show the last {limit} events for service {serviceId}, oldest first set to {ascending}.
        slots:
          limit: requestBody.limit
          serviceId: requestBody.serviceId
          ascending: requestBody.ascending
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/updateSshKey'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a cluster's SSH key
      effect: write
      questions:
      - How do I rotate the SSH key on a CDW cluster?
      - Can I change the SSH key for a Data Warehouse cluster after it's created?
      instructions:
      - text: Update the SSH key for cluster {clusterId}.
        slots:
          clusterId: requestBody.clusterId
      - text: Rotate the SSH key on Data Warehouse cluster {clusterId}.
        slots:
          clusterId: requestBody.clusterId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/renewCertificates'].post
  update:
    x-apievangelist-phrasing:
      intent: Renew certificates on a public cloud cluster
      effect: write
      questions:
      - My CDW public cloud cluster certificates are expiring; how do I renew them?
      - Can I refresh TLS certificates on a Data Warehouse cluster?
      instructions:
      - text: Renew the certificates on cluster {clusterId}.
        slots:
          clusterId: requestBody.clusterId
      - text: Refresh expiring certs for public cloud CDW cluster {clusterId}.
        slots:
          clusterId: requestBody.clusterId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/createCluster'].post
  update:
    x-apievangelist-phrasing:
      intent: Activate a Data Warehouse cluster (generic)
      effect: write
      questions:
      - How do I activate Cloudera Data Warehouse on an environment with one generic call?
      - Can I restrict cluster access to certain IP ranges when activating Data Warehouse?
      instructions:
      - text: Create a Data Warehouse cluster in environment {environmentCrn}.
        slots:
          environmentCrn: requestBody.environmentCrn
      - text: Activate CDW on {environmentCrn} with a private load balancer set to {usePrivateLoadBalancer} and allowed CIDRs {whitelistIpCIDRs}.
        slots:
          environmentCrn: requestBody.environmentCrn
          usePrivateLoadBalancer: requestBody.usePrivateLoadBalancer
          whitelistIpCIDRs: requestBody.whitelistIpCIDRs
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/createAwsCluster'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an AWS Data Warehouse cluster
      effect: write
      questions:
      - What does it take to stand up a CDW cluster on AWS with private EKS?
      - Can my AWS Data Warehouse cluster use spot instances or a custom AMI?
      instructions:
      - text: Create an AWS Data Warehouse cluster in environment {environmentCrn}.
        slots:
          environmentCrn: requestBody.environmentCrn
      - text: Spin up an AWS CDW cluster in {environmentCrn} on worker subnets {workerSubnetIds} with spot instances {enableSpotInstances}.
        slots:
          environmentCrn: requestBody.environmentCrn
          workerSubnetIds: requestBody.workerSubnetIds
          enableSpotInstances: requestBody.enableSpotInstances
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/createAzureCluster'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an Azure Data Warehouse cluster
      effect: write
      questions:
      - What do I need to create a CDW cluster on Azure, like a managed identity and subnet?
      - Can an Azure Data Warehouse cluster run on a private AKS cluster?
      instructions:
      - text: Create an Azure Data Warehouse cluster in {environmentCrn} using identity {userAssignedManagedIdentity} on subnet {subnetName}.
        slots:
          environmentCrn: requestBody.environmentCrn
          userAssignedManagedIdentity: requestBody.userAssignedManagedIdentity
          subnetName: requestBody.subnetName
      - text: Spin up an AKS-backed CDW cluster in {environmentCrn} on subnet {subnetName} with identity {userAssignedManagedIdentity} and private AKS {enablePrivateAks}.
        slots:
          environmentCrn: requestBody.environmentCrn
          subnetName: requestBody.subnetName
          userAssignedManagedIdentity: requestBody.userAssignedManagedIdentity
          enablePrivateAks: requestBody.enablePrivateAks
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/createPrivateCluster'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a Private Cloud Data Warehouse cluster
      effect: write
      questions:
      - How do I activate Data Warehouse on a Private Cloud environment?
      - Can I pick a storage class or dedicated executor nodes for a Private Cloud CDW cluster?
      instructions:
      - text: Create a Private Cloud Data Warehouse cluster in {environmentCrn}.
        slots:
          environmentCrn: requestBody.environmentCrn
      - text: Activate on-prem CDW in {environmentCrn} using storage class {storageClass}.
        slots:
          environmentCrn: requestBody.environmentCrn
          storageClass: requestBody.storageClass
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/deleteCluster'].post
  update:
    x-apievangelist-phrasing:
      intent: Delete a Data Warehouse cluster
      effect: destructive
      questions:
      - How do I tear down a whole Cloudera Data Warehouse cluster?
      - Can I force-delete a CDW cluster that's stuck?
      instructions:
      - text: Delete Data Warehouse cluster {clusterId}.
        slots:
          clusterId: requestBody.clusterId
      - text: Force the deletion of CDW cluster {clusterId} with force {force}.
        slots:
          clusterId: requestBody.clusterId
          force: requestBody.force
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/updateCluster'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a Data Warehouse cluster's settings
      effect: write
      questions:
      - Can I change the allowed IP ranges on an existing CDW cluster?
      - Where do I update a cluster's description or observability config?
      instructions:
      - text: Update cluster {clusterId} to allow CIDRs {whitelistIpCIDRs}.
        slots:
          clusterId: requestBody.clusterId
          whitelistIpCIDRs: requestBody.whitelistIpCIDRs
      - text: Change the description of Data Warehouse cluster {clusterId} to {description}.
        slots:
          clusterId: requestBody.clusterId
          description: requestBody.description
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/backupCluster'].post
  update:
    x-apievangelist-phrasing:
      intent: Export a cluster's configuration as backup data
      effect: read
      questions:
      - How do I export a cluster's configuration, including its Virtual Warehouses and Data Viz apps?
      - Can I capture CDW cluster settings so I can restore them later?
      instructions:
      - text: Back up the configuration of cluster {clusterId}.
        slots:
          clusterId: requestBody.clusterId
      - text: Export the settings of {clusterId} and its catalogs and warehouses as backup data.
        slots:
          clusterId: requestBody.clusterId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/restoreCluster'].post
  update:
    x-apievangelist-phrasing:
      intent: Restore a cluster from exported configuration
      effect: write
      questions:
      - How do I recreate my Virtual Warehouses and Data Viz apps from a cluster configuration export?
      - What does restoring a cluster from backup-cluster data bring back?
      instructions:
      - text: Restore cluster {clusterId} from backup data {data}.
        slots:
          clusterId: requestBody.clusterId
          data: requestBody.data
      - text: Rebuild the warehouses and catalog config on {clusterId} using the exported settings {data}.
        slots:
          clusterId: requestBody.clusterId
          data: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/createDataVisualization'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a Data Visualization app
      effect: write
      questions:
      - How do I add a Cloudera Data Visualization app to my warehouse cluster?
      - Can I choose an image version or resource template for a new Data Viz app?
      instructions:
      - text: Create a Data Visualization app named {name} on cluster {clusterId} with config {config}.
        slots:
          name: requestBody.name
          clusterId: requestBody.clusterId
          config: requestBody.config
      - text: Deploy Data Viz {name} on {clusterId} using config {config} and image {imageVersion}.
        slots:
          name: requestBody.name
          clusterId: requestBody.clusterId
          config: requestBody.config
          imageVersion: requestBody.imageVersion
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/listDataVisualizations'].post
  update:
    x-apievangelist-phrasing:
      intent: List Data Visualization apps in a cluster
      effect: read
      questions:
      - Which Data Visualization apps are running on my CDW cluster?
      - What dashboards apps exist in a given warehouse cluster?
      instructions:
      - text: List the Data Visualization apps on cluster {clusterId}.
        slots:
          clusterId: requestBody.clusterId
      - text: Show all Data Viz instances in {clusterId}.
        slots:
          clusterId: requestBody.clusterId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/deleteDataVisualization'].post
  update:
    x-apievangelist-phrasing:
      intent: Delete a Data Visualization app
      effect: destructive
      questions:
      - How do I remove a Data Visualization app from a cluster?
      - Can I still check a Data Viz app's status while it's being deleted?
      instructions:
      - text: Delete Data Visualization {dataVisualizationId} on cluster {clusterId}.
        slots:
          dataVisualizationId: requestBody.dataVisualizationId
          clusterId: requestBody.clusterId
      - text: Tear down the Data Viz app {dataVisualizationId} in {clusterId}.
        slots:
          dataVisualizationId: requestBody.dataVisualizationId
          clusterId: requestBody.clusterId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/describeDataVisualization'].post
  update:
    x-apievangelist-phrasing:
      intent: Get details and status of a Data Visualization app
      effect: read
      questions:
      - What state is my Data Visualization app in after an update or upgrade?
      - Which config and version is a specific Data Viz app running?
      instructions:
      - text: Describe Data Visualization {dataVisualizationId} on cluster {clusterId}.
        slots:
          dataVisualizationId: requestBody.dataVisualizationId
          clusterId: requestBody.clusterId
      - text: Check the current status of Data Viz app {dataVisualizationId} in {clusterId}.
        slots:
          dataVisualizationId: requestBody.dataVisualizationId
          clusterId: requestBody.clusterId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/updateDataVisualization'].post
  update:
    x-apievangelist-phrasing:
      intent: Change a Data Visualization app's configuration
      effect: write
      questions:
      - Can I reconfigure a running Data Visualization app?
      - Is changing a Data Viz app's settings asynchronous?
      instructions:
      - text: Update Data Visualization {dataVisualizationId} on {clusterId} with config {config}.
        slots:
          dataVisualizationId: requestBody.dataVisualizationId
          clusterId: requestBody.clusterId
          config: requestBody.config
      - text: Apply new settings {config} to Data Viz app {dataVisualizationId} in cluster {clusterId}.
        slots:
          config: requestBody.config
          dataVisualizationId: requestBody.dataVisualizationId
          clusterId: requestBody.clusterId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/getDataVisualizationUpgradeVersion'].post
  update:
    x-apievangelist-phrasing:
      intent: Check upgrade versions for a Data Visualization app
      effect: read
      questions:
      - Is there a newer compatible version for my Data Visualization app?
      - What's the latest Data Viz version I could upgrade to?
      instructions:
      - text: Get the upgrade versions for Data Visualization {dataVisualizationId} on {clusterId}.
        slots:
          dataVisualizationId: requestBody.dataVisualizationId
          clusterId: requestBody.clusterId
      - text: Tell me the latest compatible Data Viz release for app {dataVisualizationId} in {clusterId}.
        slots:
          dataVisualizationId: requestBody.dataVisualizationId
          clusterId: requestBody.clusterId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/upgradeDataVisualization'].post
  update:
    x-apievangelist-phrasing:
      intent: Upgrade a Data Visualization app
      effect: write
      questions:
      - How do I move a Data Visualization app to a newer image version?
      - Can I change the resource pool while upgrading a Data Viz app?
      instructions:
      - text: Upgrade Data Visualization {dataVisualizationId} on {clusterId} to version {imageVersion}.
        slots:
          dataVisualizationId: requestBody.dataVisualizationId
          clusterId: requestBody.clusterId
          imageVersion: requestBody.imageVersion
      - text: Move Data Viz app {dataVisualizationId} in {clusterId} to image {imageVersion} in resource pool {resourcePool}.
        slots:
          dataVisualizationId: requestBody.dataVisualizationId
          clusterId: requestBody.clusterId
          imageVersion: requestBody.imageVersion
          resourcePool: requestBody.resourcePool
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/registerSecret'].post
  update:
    x-apievangelist-phrasing:
      intent: Register a cloud vault secret reference
      effect: write
      questions:
      - How do I point CDW at a secret already stored in my cloud provider's vault?
      - Can I reference an Azure Key Vault secret for an external data source connection?
      instructions:
      - text: Register vault secret {secretName} for cluster {clusterId}.
        slots:
          secretName: requestBody.secretName
          clusterId: requestBody.clusterId
      - text: Reference secret {secretName} from Azure vault {azureVaultName} on cluster {clusterId}.
        slots:
          secretName: requestBody.secretName
          azureVaultName: requestBody.azureVaultName
          clusterId: requestBody.clusterId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/createSecret'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a secret in the cluster's Kubernetes
      effect: write
      questions:
      - How do I store a password for an external data source directly in my CDW Kubernetes cluster?
      - Can I create a new Kubernetes secret value through the Data Warehouse API?
      instructions:
      - text: Create a Kubernetes secret {secretName} on cluster {clusterId} with value {secretValue}.
        slots:
          secretName: requestBody.secretName
          clusterId: requestBody.clusterId
          secretValue: requestBody.secretValue
      - text: Store the credential {secretValue} as k8s secret {secretName} in {clusterId}.
        slots:
          secretValue: requestBody.secretValue
          secretName: requestBody.secretName
          clusterId: requestBody.clusterId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/listSecrets'].post
  update:
    x-apievangelist-phrasing:
      intent: List secrets for a cluster
      effect: read
      questions:
      - Which secrets are registered for external data sources on my cluster?
      - What cloud provider secrets has CDW recorded in this environment?
      instructions:
      - text: List the secrets on cluster {clusterId}.
        slots:
          clusterId: requestBody.clusterId
      - text: Show every stored secret name for {clusterId}.
        slots:
          clusterId: requestBody.clusterId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/deleteSecret'].post
  update:
    x-apievangelist-phrasing:
      intent: Delete a stored secret
      effect: destructive
      questions:
      - How do I remove a secret I no longer need for a data source?
      - Can I delete a secret by name from a CDW cluster?
      instructions:
      - text: Delete secret {secretName} from cluster {clusterId}.
        slots:
          secretName: requestBody.secretName
          clusterId: requestBody.clusterId
      - text: Remove the {secretName} secret on {clusterId}.
        slots:
          secretName: requestBody.secretName
          clusterId: requestBody.clusterId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/createConnector'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a database connector
      effect: write
      questions:
      - How do I add a Trino connector to an external database in my CDW cluster?
      - What template and config does a new database connector need?
      instructions:
      - text: Create connector {name} from template {template} on cluster {clusterId}.
        slots:
          name: requestBody.name
          template: requestBody.template
          clusterId: requestBody.clusterId
      - text: Add a new database connector {name} using template {template} with config {config}.
        slots:
          name: requestBody.name
          template: requestBody.template
          config: requestBody.config
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/createConnectorTestJob'].post
  update:
    x-apievangelist-phrasing:
      intent: Test a Trino connector
      effect: write
      questions:
      - Can I check that a Trino connector actually reaches its data source before using it?
      - How do I run a connection test for a connector config I haven't saved yet?
      instructions:
      - text: Test connector {connectorId} on cluster {clusterId}.
        slots:
          connectorId: requestBody.connectorId
          clusterId: requestBody.clusterId
      - text: Run a connection test on {clusterId} for connector {connectorName} with config {config}.
        slots:
          clusterId: requestBody.clusterId
          connectorName: requestBody.connectorName
          config: requestBody.config
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/listConnectorTestJobs'].post
  update:
    x-apievangelist-phrasing:
      intent: List connector test jobs
      effect: read
      questions:
      - Did my Trino connector tests pass?
      - Where can I see the results of past connector test runs?
      instructions:
      - text: List connector test jobs on cluster {clusterId}.
        slots:
          clusterId: requestBody.clusterId
      - text: Show the result of connector test {jobId} in {clusterId}.
        slots:
          jobId: requestBody.jobId
          clusterId: requestBody.clusterId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/listConnectors'].post
  update:
    x-apievangelist-phrasing:
      intent: List database connectors in a cluster
      effect: read
      questions:
      - Which database connectors are configured on my CDW cluster?
      - What external sources can my warehouse query through connectors?
      instructions:
      - text: List the database connectors on cluster {clusterId}.
        slots:
          clusterId: requestBody.clusterId
      - text: Show all connectors defined in {clusterId}.
        slots:
          clusterId: requestBody.clusterId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/deleteConnector'].post
  update:
    x-apievangelist-phrasing:
      intent: Delete a database connector
      effect: destructive
      questions:
      - How do I remove a database connector from a cluster?
      - Can I delete a connector my warehouses no longer use?
      instructions:
      - text: Delete connector {connectorId} from cluster {clusterId}.
        slots:
          connectorId: requestBody.connectorId
          clusterId: requestBody.clusterId
      - text: Remove database connector {connectorId} in {clusterId}.
        slots:
          connectorId: requestBody.connectorId
          clusterId: requestBody.clusterId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/updateConnector'].post
  update:
    x-apievangelist-phrasing:
      intent: Edit an existing database connector
      effect: write
      questions:
      - Can I rename or change the config of a connector I already created?
      - How do I switch an existing connector to a different template?
      instructions:
      - text: Update connector {connectorId} on {clusterId} with config {config}.
        slots:
          connectorId: requestBody.connectorId
          clusterId: requestBody.clusterId
          config: requestBody.config
      - text: Rename existing connector {connectorId} in {clusterId} to {name}.
        slots:
          connectorId: requestBody.connectorId
          clusterId: requestBody.clusterId
          name: requestBody.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/createDbc'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a Database Catalog (deprecated)
      effect: write
      questions:
      - Can I still create an extra Database Catalog even though it's deprecated?
      - Is it possible to load demo data when making a new Database Catalog?
      instructions:
      - text: Create Database Catalog {name} on cluster {clusterId}.
        slots:
          name: requestBody.name
          clusterId: requestBody.clusterId
      - text: Make a new catalog {name} in {clusterId} with demo data {loadDemoData}.
        slots:
          name: requestBody.name
          clusterId: requestBody.clusterId
          loadDemoData: requestBody.loadDemoData
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/listDbcs'].post
  update:
    x-apievangelist-phrasing:
      intent: List Database Catalogs in a cluster
      effect: read
      questions:
      - Which Database Catalogs exist on my CDW cluster?
      - What's the ID of the default Database Catalog in a cluster?
      instructions:
      - text: List the Database Catalogs on cluster {clusterId}.
        slots:
          clusterId: requestBody.clusterId
      - text: Show every DBC in {clusterId}.
        slots:
          clusterId: requestBody.clusterId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/describeDbc'].post
  update:
    x-apievangelist-phrasing:
      intent: Get details of a Database Catalog
      effect: read
      questions:
      - Is my Database Catalog running or suspended?
      - What version and status does a specific DBC report?
      instructions:
      - text: Describe Database Catalog {dbcId} on cluster {clusterId}.
        slots:
          dbcId: requestBody.dbcId
          clusterId: requestBody.clusterId
      - text: Show the status of DBC {dbcId} in {clusterId}.
        slots:
          dbcId: requestBody.dbcId
          clusterId: requestBody.clusterId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/deleteDbc'].post
  update:
    x-apievangelist-phrasing:
      intent: Delete a Database Catalog
      effect: destructive
      questions:
      - How do I permanently remove a Database Catalog?
      - Can I delete a DBC I created by mistake?
      instructions:
      - text: Delete Database Catalog {dbcId} from cluster {clusterId}.
        slots:
          dbcId: requestBody.dbcId
          clusterId: requestBody.clusterId
      - text: Remove DBC {dbcId} in {clusterId}.
        slots:
          dbcId: requestBody.dbcId
          clusterId: requestBody.clusterId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/rebuildDbc'].post
  update:
    x-apievangelist-phrasing:
      intent: Rebuild a broken Database Catalog
      effect: write
      questions:
      - My Database Catalog is in an erroneous state; can I rebuild it?
      - Is it safe to rebuild a running DBC?
      instructions:
      - text: Rebuild Database Catalog {dbcId} on cluster {clusterId}.
        slots:
          dbcId: requestBody.dbcId
          clusterId: requestBody.clusterId
      - text: Fix inconsistent DBC {dbcId} in {clusterId} by rebuilding it.
        slots:
          dbcId: requestBody.dbcId
          clusterId: requestBody.clusterId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/suspendDbc'].post
  update:
    x-apievangelist-phrasing:
      intent: Suspend a running Database Catalog
      effect: write
      questions:
      - How do I pause a Database Catalog to save resources?
      - What happens if I suspend a DBC that's already suspended?
      instructions:
      - text: Suspend Database Catalog {dbcId} on cluster {clusterId}.
        slots:
          dbcId: requestBody.dbcId
          clusterId: requestBody.clusterId
      - text: Pause DBC {dbcId} in {clusterId}.
        slots:
          dbcId: requestBody.dbcId
          clusterId: requestBody.clusterId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/startDbc'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a Database Catalog
      effect: write
      questions:
      - How do I bring a suspended Database Catalog back up?
      - Can I force a refresh when starting a DBC?
      instructions:
      - text: Start Database Catalog {dbcId} on cluster {clusterId}.
        slots:
          dbcId: requestBody.dbcId
          clusterId: requestBody.clusterId
      - text: Resume DBC {dbcId} in {clusterId} with force refresh {forceRefresh}.
        slots:
          dbcId: requestBody.dbcId
          clusterId: requestBody.clusterId
          forceRefresh: requestBody.forceRefresh
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/describeDbcConfig'].post
  update:
    x-apievangelist-phrasing:
      intent: Show a Database Catalog's current configuration
      effect: read
      questions:
      - What configuration is my Database Catalog using right now?
      - Which config values are set on a DBC's components?
      instructions:
      - text: Show the current configuration of Database Catalog {dbcId} on {clusterId}.
        slots:
          dbcId: requestBody.dbcId
          clusterId: requestBody.clusterId
      - text: Dump the live config settings of DBC {dbcId} in cluster {clusterId}.
        slots:
          dbcId: requestBody.dbcId
          clusterId: requestBody.clusterId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/updateDbcConfig'].post
  update:
    x-apievangelist-phrasing:
      intent: Change a Database Catalog component's config
      effect: write
      questions:
      - How do I change a configuration file for one component of a Database Catalog?
      - Can I set specific config values on a DBC component like the metastore?
      instructions:
      - text: Update the {component} config of Database Catalog {dbcId} on {clusterId} to {set}.
        slots:
          component: requestBody.component
          dbcId: requestBody.dbcId
          clusterId: requestBody.clusterId
          set: requestBody.set
      - text: Set component {component} values on DBC {dbcId} in cluster {clusterId}.
        slots:
          component: requestBody.component
          dbcId: requestBody.dbcId
          clusterId: requestBody.clusterId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/createDbcDiagnosticDataJob'].post
  update:
    x-apievangelist-phrasing:
      intent: Collect diagnostics for a Database Catalog
      effect: write
      questions:
      - How do I gather logs and metrics from a Database Catalog for troubleshooting?
      - Can I attach a support case number to a DBC diagnostic bundle?
      instructions:
      - text: Start a diagnostic job for Database Catalog {dbcId} on {clusterId} sending to {destination}.
        slots:
          dbcId: requestBody.dbcId
          clusterId: requestBody.clusterId
          destination: requestBody.destination
      - text: Collect DBC {dbcId} logs in {clusterId} for case {caseNumber}, uploaded to {destination}.
        slots:
          dbcId: requestBody.dbcId
          clusterId: requestBody.clusterId
          caseNumber: requestBody.caseNumber
          destination: requestBody.destination
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/listDbcDiagnosticDataJobs'].post
  update:
    x-apievangelist-phrasing:
      intent: List diagnostic jobs for a Database Catalog
      effect: read
      questions:
      - What diagnostic bundles have been collected for my Database Catalog?
      - Can I filter DBC diagnostic jobs by status?
      instructions:
      - text: List diagnostic jobs for Database Catalog {dbcId} on {clusterId}.
        slots:
          dbcId: requestBody.dbcId
          clusterId: requestBody.clusterId
      - text: Show DBC {dbcId} diagnostics jobs in {clusterId} with status {status}.
        slots:
          dbcId: requestBody.dbcId
          clusterId: requestBody.clusterId
          status: requestBody.status
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/describeDbcDiagnosticDataJob'].post
  update:
    x-apievangelist-phrasing:
      intent: Get one Database Catalog diagnostic job
      effect: read
      questions:
      - Has the diagnostic bundle for my Database Catalog finished collecting?
      - What status is a specific DBC diagnostic job in?
      instructions:
      - text: Describe diagnostic job {jobId} for Database Catalog {dbcId} on {clusterId}.
        slots:
          jobId: requestBody.jobId
          dbcId: requestBody.dbcId
          clusterId: requestBody.clusterId
      - text: Check DBC {dbcId} diagnostics job {jobId} in cluster {clusterId}.
        slots:
          dbcId: requestBody.dbcId
          jobId: requestBody.jobId
          clusterId: requestBody.clusterId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/deleteDbcDiagnosticDataJob'].post
  update:
    x-apievangelist-phrasing:
      intent: Delete a Database Catalog diagnostic job
      effect: destructive
      questions:
      - Can I delete a Database Catalog diagnostic job that's still running?
      - How do I clean up old DBC diagnostic jobs?
      instructions:
      - text: Delete diagnostic job {jobId} for Database Catalog {dbcId} on {clusterId}.
        slots:
          jobId: requestBody.jobId
          dbcId: requestBody.dbcId
          clusterId: requestBody.clusterId
      - text: Remove DBC {dbcId} diagnostics job {jobId} from {clusterId}.
        slots:
          dbcId: requestBody.dbcId
          jobId: requestBody.jobId
          clusterId: requestBody.clusterId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/listDbcEvents'].post
  update:
    x-apievangelist-phrasing:
      intent: List events for a Database Catalog
      effect: read
      questions:
      - What has happened to my Database Catalog recently?
      - Can I see a DBC's event history newest or oldest first?
      instructions:
      - text: List events for Database Catalog {dbcId} on {clusterId}.
        slots:
          dbcId: requestBody.dbcId
          clusterId: requestBody.clusterId
      - text: Show the last {limit} events of DBC {dbcId} in {clusterId}.
        slots:
          limit: requestBody.limit
          dbcId: requestBody.dbcId
          clusterId: requestBody.clusterId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/createVw'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a Virtual Warehouse
      effect: write
      questions:
      - How do I create a new Hive or Impala Virtual Warehouse?
      - Can I set a t-shirt size, node count and autoscaling when making a Virtual Warehouse?
      - Which Database Catalog does a new Virtual Warehouse attach to?
      instructions:
      - text: Create a {vwType} Virtual Warehouse named {name} on catalog {dbcId} in cluster {clusterId}.
        slots:
          vwType: requestBody.vwType
          name: requestBody.name
          dbcId: requestBody.dbcId
          clusterId: requestBody.clusterId
      - text: Spin up {vwType} warehouse {name} in {clusterId} on DBC {dbcId} at size {tShirtSize}.
        slots:
          vwType: requestBody.vwType
          name: requestBody.name
          clusterId: requestBody.clusterId
          dbcId: requestBody.dbcId
          tShirtSize: requestBody.tShirtSize
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/listVws'].post
  update:
    x-apievangelist-phrasing:
      intent: List Virtual Warehouses in a cluster
      effect: read
      questions:
      - Which Virtual Warehouses exist on my CDW cluster?
      - Can I filter the list of Virtual Warehouses?
      instructions:
      - text: List the Virtual Warehouses on cluster {clusterId}.
        slots:
          clusterId: requestBody.clusterId
      - text: Show warehouses in {clusterId} matching filter {filter}.
        slots:
          clusterId: requestBody.clusterId
          filter: requestBody.filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/describeVw'].post
  update:
    x-apievangelist-phrasing:
      intent: Get details of a Virtual Warehouse
      effect: read
      questions:
      - Is my Virtual Warehouse running, and what size is it?
      - What are the endpoints and status of a specific Virtual Warehouse?
      instructions:
      - text: Describe Virtual Warehouse {vwId} on cluster {clusterId}.
        slots:
          vwId: requestBody.vwId
          clusterId: requestBody.clusterId
      - text: Show me the status of warehouse {vwId} in {clusterId}.
        slots:
          vwId: requestBody.vwId
          clusterId: requestBody.clusterId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/updateVwConfig'].post
  update:
    x-apievangelist-phrasing:
      intent: Change a Virtual Warehouse component's config
      effect: write
      questions:
      - How do I edit a configuration file for one component of a Virtual Warehouse?
      - Can I set specific values in a Hive or Impala component config?
      instructions:
      - text: Update the {component} config of Virtual Warehouse {vwId} on {clusterId} to {set}.
        slots:
          component: requestBody.component
          vwId: requestBody.vwId
          clusterId: requestBody.clusterId
          set: requestBody.set
      - text: Set component {component} values on warehouse {vwId} in cluster {clusterId}.
        slots:
          component: requestBody.component
          vwId: requestBody.vwId
          clusterId: requestBody.clusterId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/deleteVw'].post
  update:
    x-apievangelist-phrasing:
      intent: Delete a Virtual Warehouse
      effect: destructive
      questions:
      - How do I permanently remove a Virtual Warehouse?
      - Can I delete a Hive or Impala warehouse I no longer need?
      instructions:
      - text: Delete Virtual Warehouse {vwId} from cluster {clusterId}.
        slots:
          vwId: requestBody.vwId
          clusterId: requestBody.clusterId
      - text: Remove warehouse {vwId} in {clusterId}.
        slots:
          vwId: requestBody.vwId
          clusterId: requestBody.clusterId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/rebuildVw'].post
  update:
    x-apievangelist-phrasing:
      intent: Rebuild a broken Virtual Warehouse
      effect: write
      questions:
      - My Virtual Warehouse is stuck in an error state; can I rebuild it?
      - Is rebuilding a stopped Virtual Warehouse safe?
      instructions:
      - text: Rebuild Virtual Warehouse {vwId} on cluster {clusterId}.
        slots:
          vwId: requestBody.vwId
          clusterId: requestBody.clusterId
      - text: Fix inconsistent warehouse {vwId} in {clusterId} by rebuilding it.
        slots:
          vwId: requestBody.vwId
          clusterId: requestBody.clusterId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/startVw'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a suspended Virtual Warehouse
      effect: write
      questions:
      - How do I wake up a suspended Virtual Warehouse?
      - What happens if I start a warehouse that's already running?
      instructions:
      - text: Start Virtual Warehouse {vwId} on cluster {clusterId}.
        slots:
          vwId: requestBody.vwId
          clusterId: requestBody.clusterId
      - text: Resume warehouse {vwId} in {clusterId} with force refresh {forceRefresh}.
        slots:
          vwId: requestBody.vwId
          clusterId: requestBody.clusterId
          forceRefresh: requestBody.forceRefresh
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/suspendVw'].post
  update:
    x-apievangelist-phrasing:
      intent: Suspend a running Virtual Warehouse
      effect: write
      questions:
      - Can I pause a Virtual Warehouse to stop paying for its compute?
      - Does suspending an already suspended warehouse do anything?
      instructions:
      - text: Suspend Virtual Warehouse {vwId} on cluster {clusterId}.
        slots:
          vwId: requestBody.vwId
          clusterId: requestBody.clusterId
      - text: Pause warehouse {vwId} in {clusterId}.
        slots:
          vwId: requestBody.vwId
          clusterId: requestBody.clusterId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/createVwDiagnosticDataJob'].post
  update:
    x-apievangelist-phrasing:
      intent: Collect diagnostics for a Virtual Warehouse
      effect: write
      questions:
      - How do I collect Hive or Impala logs from a Virtual Warehouse for a support ticket?
      - Can I limit a Virtual Warehouse diagnostic bundle to a time range?
      instructions:
      - text: Start a diagnostic job for Virtual Warehouse {vwId} on {clusterId} sending to {destination}.
        slots:
          vwId: requestBody.vwId
          clusterId: requestBody.clusterId
          destination: requestBody.destination
      - text: Collect warehouse {vwId} logs in {clusterId} from {startTime} to {endTime}, uploaded to {destination}.
        slots:
          vwId: requestBody.vwId
          clusterId: requestBody.clusterId
          startTime: requestBody.startTime
          endTime: requestBody.endTime
          destination: requestBody.destination
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/listVwDiagnosticDataJobs'].post
  update:
    x-apievangelist-phrasing:
      intent: List diagnostic jobs for a Virtual Warehouse
      effect: read
      questions:
      - What diagnostic bundles exist for my Virtual Warehouse?
      - Can I page through a warehouse's diagnostic jobs?
      instructions:
      - text: List diagnostic jobs for Virtual Warehouse {vwId} on {clusterId}.
        slots:
          vwId: requestBody.vwId
          clusterId: requestBody.clusterId
      - text: Show warehouse {vwId} diagnostics jobs in {clusterId} with status {status}.
        slots:
          vwId: requestBody.vwId
          clusterId: requestBody.clusterId
          status: requestBody.status
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/describeVwDiagnosticDataJob'].post
  update:
    x-apievangelist-phrasing:
      intent: Get one Virtual Warehouse diagnostic job
      effect: read
      questions:
      - Is the diagnostic bundle for my Virtual Warehouse ready?
      - What's the status of one warehouse diagnostic job?
      instructions:
      - text: Describe diagnostic job {jobId} for Virtual Warehouse {vwId} on {clusterId}.
        slots:
          jobId: requestBody.jobId
          vwId: requestBody.vwId
          clusterId: requestBody.clusterId
      - text: Check warehouse {vwId} diagnostics job {jobId} in cluster {clusterId}.
        slots:
          vwId: requestBody.vwId
          jobId: requestBody.jobId
          clusterId: requestBody.clusterId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/deleteVwDiagnosticDataJob'].post
  update:
    x-apievangelist-phrasing:
      intent: Delete a Virtual Warehouse diagnostic job
      effect: destructive
      questions:
      - Can I delete a Virtual Warehouse diagnostic job while it's running?
      - How do I remove an old warehouse diagnostic bundle job?
      instructions:
      - text: Delete diagnostic job {jobId} for Virtual Warehouse {vwId} on {clusterId}.
        slots:
          jobId: requestBody.jobId
          vwId: requestBody.vwId
          clusterId: requestBody.clusterId
      - text: Remove warehouse {vwId} diagnostics job {jobId} from {clusterId}.
        slots:
          vwId: requestBody.vwId
          jobId: requestBody.jobId
          clusterId: requestBody.clusterId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/listVwEvents'].post
  update:
    x-apievangelist-phrasing:
      intent: List events for a Virtual Warehouse
      effect: read
      questions:
      - What's happened to my Virtual Warehouse lately, like scaling or restarts?
      - Can I read a warehouse's events in ascending order?
      instructions:
      - text: List events for Virtual Warehouse {vwId} on {clusterId}.
        slots:
          vwId: requestBody.vwId
          clusterId: requestBody.clusterId
      - text: Show the last {limit} events of warehouse {vwId} in {clusterId}.
        slots:
          limit: requestBody.limit
          vwId: requestBody.vwId
          clusterId: requestBody.clusterId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/listLatestVersions'].post
  update:
    x-apievangelist-phrasing:
      intent: List the latest product versions for catalogs
      effect: read
      questions:
      - Is a newer Data Warehouse release available for the catalogs in my environment?
      - What's the newest version across all my Database Catalogs?
      instructions:
      - text: List the latest available versions for catalogs on cluster {clusterId}.
        slots:
          clusterId: requestBody.clusterId
      - text: Show the newest product release for every catalog in {clusterId}.
        slots:
          clusterId: requestBody.clusterId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/describeVwConfig'].post
  update:
    x-apievangelist-phrasing:
      intent: Show a Virtual Warehouse's current configuration
      effect: read
      questions:
      - What configuration is my Hive or Impala Virtual Warehouse running with?
      - Which config values are set on a warehouse's components right now?
      instructions:
      - text: Show the current configuration of Virtual Warehouse {vwId} on {clusterId}.
        slots:
          vwId: requestBody.vwId
          clusterId: requestBody.clusterId
      - text: Dump the live config settings of warehouse {vwId} in cluster {clusterId}.
        slots:
          vwId: requestBody.vwId
          clusterId: requestBody.clusterId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/describeConfig'].post
  update:
    x-apievangelist-phrasing:
      intent: Get one saved service configuration by ID
      effect: read
      questions:
      - Can I look at a specific historical configuration version by its config ID?
      - What did a service configuration contain at a particular revision?
      instructions:
      - text: Describe service configuration {configId} on cluster {clusterId}.
        slots:
          configId: requestBody.configId
          clusterId: requestBody.clusterId
      - text: Show me config revision {configId} in {clusterId}.
        slots:
          configId: requestBody.configId
          clusterId: requestBody.clusterId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/describeConfigDiff'].post
  update:
    x-apievangelist-phrasing:
      intent: Compare two service configurations
      effect: read
      questions:
      - What changed between two versions of a warehouse or catalog configuration?
      - Can I diff an old service config against the current one?
      instructions:
      - text: Diff configuration {fromConfigId} against {toConfigId} on cluster {clusterId}.
        slots:
          fromConfigId: requestBody.fromConfigId
          toConfigId: requestBody.toConfigId
          clusterId: requestBody.clusterId
      - text: Show what changed from config {fromConfigId} to {toConfigId} in {clusterId}.
        slots:
          fromConfigId: requestBody.fromConfigId
          toConfigId: requestBody.toConfigId
          clusterId: requestBody.clusterId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/listDbcConfigs'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a Database Catalog's configuration history
      effect: read
      questions:
      - How has my Database Catalog's configuration changed over time?
      - Where can I find past config versions of a DBC?
      instructions:
      - text: List the configuration history of Database Catalog {dbcId} on {clusterId}.
        slots:
          dbcId: requestBody.dbcId
          clusterId: requestBody.clusterId
      - text: Show previous config revisions for DBC {dbcId} in cluster {clusterId}.
        slots:
          dbcId: requestBody.dbcId
          clusterId: requestBody.clusterId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/listVwConfigs'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a Virtual Warehouse's configuration history
      effect: read
      questions:
      - How has my Virtual Warehouse configuration changed over time?
      - Where can I find past config versions of a warehouse?
      instructions:
      - text: List the configuration history of Virtual Warehouse {vwId} on {clusterId}.
        slots:
          vwId: requestBody.vwId
          clusterId: requestBody.clusterId
      - text: Show previous config revisions for warehouse {vwId} in cluster {clusterId}.
        slots:
          vwId: requestBody.vwId
          clusterId: requestBody.clusterId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/updateVw'].post
  update:
    x-apievangelist-phrasing:
      intent: Resize or reconfigure a Virtual Warehouse
      effect: write
      questions:
      - Can I change a Virtual Warehouse's size or node count after it's created?
      - How do I adjust autoscaling or attach connectors to an existing warehouse?
      instructions:
      - text: Resize Virtual Warehouse {vwId} on {clusterId} to t-shirt size {tShirtSize}.
        slots:
          vwId: requestBody.vwId
          clusterId: requestBody.clusterId
          tShirtSize: requestBody.tShirtSize
      - text: Set autoscaling on warehouse {vwId} in {clusterId} to {autoscaling}.
        slots:
          vwId: requestBody.vwId
          clusterId: requestBody.clusterId
          autoscaling: requestBody.autoscaling
      - text: Attach connectors {associatedConnectors} to warehouse {vwId} in {clusterId}.
        slots:
          associatedConnectors: requestBody.associatedConnectors
          vwId: requestBody.vwId
          clusterId: requestBody.clusterId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/updateDbc'].post
  update:
    x-apievangelist-phrasing:
      intent: Change a Database Catalog's resources or config
      effect: write
      questions:
      - Can I move a Database Catalog to a different resource template?
      - Where do I update the overall settings of an existing DBC?
      instructions:
      - text: Switch Database Catalog {dbcId} on {clusterId} to resource template {resourceTemplateId}.
        slots:
          dbcId: requestBody.dbcId
          clusterId: requestBody.clusterId
          resourceTemplateId: requestBody.resourceTemplateId
      - text: Apply catalog settings {config} to DBC {dbcId} in cluster {clusterId}.
        slots:
          config: requestBody.config
          dbcId: requestBody.dbcId
          clusterId: requestBody.clusterId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/addUser'].post
  update:
    x-apievangelist-phrasing:
      intent: Give an existing user access to a cluster
      effect: write
      questions:
      - How do I grant someone access to my Data Warehouse cluster?
      - Does a user have to exist before I add them to a cluster?
      instructions:
      - text: Add user {userId} to cluster {clusterId}.
        slots:
          userId: requestBody.userId
          clusterId: requestBody.clusterId
      - text: Grant {userId} access to Data Warehouse cluster {clusterId}.
        slots:
          userId: requestBody.userId
          clusterId: requestBody.clusterId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/deleteUser'].post
  update:
    x-apievangelist-phrasing:
      intent: Remove a user's access to a cluster
      effect: destructive
      questions:
      - How do I revoke a user's access to a CDW cluster?
      - Does removing someone from a cluster delete their user account?
      instructions:
      - text: Remove user {userId} from cluster {clusterId}.
        slots:
          userId: requestBody.userId
          clusterId: requestBody.clusterId
      - text: Revoke {userId}'s access to Data Warehouse cluster {clusterId}.
        slots:
          userId: requestBody.userId
          clusterId: requestBody.clusterId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/listUsers'].post
  update:
    x-apievangelist-phrasing:
      intent: List users with access to a cluster
      effect: read
      questions:
      - Who has access to my Data Warehouse cluster?
      - Which users have been added to a CDW cluster?
      instructions:
      - text: List the users on cluster {clusterId}.
        slots:
          clusterId: requestBody.clusterId
      - text: Show everyone who can access {clusterId}.
        slots:
          clusterId: requestBody.clusterId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/upgradeDbc'].post
  update:
    x-apievangelist-phrasing:
      intent: Upgrade a Database Catalog
      effect: write
      questions:
      - How do I upgrade my Database Catalog to a newer compatible version?
      - Can I choose which image version a DBC upgrades to?
      instructions:
      - text: Upgrade Database Catalog {dbcId} on {clusterId} to version {imageVersion}.
        slots:
          dbcId: requestBody.dbcId
          clusterId: requestBody.clusterId
          imageVersion: requestBody.imageVersion
      - text: Move DBC {dbcId} in cluster {clusterId} onto image {imageVersion}.
        slots:
          dbcId: requestBody.dbcId
          clusterId: requestBody.clusterId
          imageVersion: requestBody.imageVersion
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/upgradeVw'].post
  update:
    x-apievangelist-phrasing:
      intent: Upgrade a Virtual Warehouse
      effect: write
      questions:
      - How do I upgrade a Virtual Warehouse to a newer compatible release?
      - Can I pick a resource pool when upgrading a warehouse?
      instructions:
      - text: Upgrade Virtual Warehouse {vwId} on catalog {dbcId} in {clusterId} to version {imageVersion}.
        slots:
          vwId: requestBody.vwId
          dbcId: requestBody.dbcId
          clusterId: requestBody.clusterId
          imageVersion: requestBody.imageVersion
      - text: Move warehouse {vwId} (DBC {dbcId}, cluster {clusterId}) onto image {imageVersion}.
        slots:
          vwId: requestBody.vwId
          dbcId: requestBody.dbcId
          clusterId: requestBody.clusterId
          imageVersion: requestBody.imageVersion
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/getUpgradeVwVersions'].post
  update:
    x-apievangelist-phrasing:
      intent: Check upgrade versions for a Virtual Warehouse
      effect: read
      questions:
      - Is there a newer compatible version for my Virtual Warehouse?
      - What's the latest release a warehouse could be upgraded to?
      instructions:
      - text: Get the upgrade versions for Virtual Warehouse {vwId} on {clusterId}.
        slots:
          vwId: requestBody.vwId
          clusterId: requestBody.clusterId
      - text: Tell me the latest compatible release for warehouse {vwId} in {clusterId}.
        slots:
          vwId: requestBody.vwId
          clusterId: requestBody.clusterId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/getUpgradeDbcVersions'].post
  update:
    x-apievangelist-phrasing:
      intent: Check upgrade versions for a Database Catalog
      effect: read
      questions:
      - Is there a newer compatible version for my Database Catalog?
      - What's the latest release a DBC could be upgraded to?
      instructions:
      - text: Get the upgrade versions for Database Catalog {dbcId} on {clusterId}.
        slots:
          dbcId: requestBody.dbcId
          clusterId: requestBody.clusterId
      - text: Tell me the latest compatible release for DBC {dbcId} in {clusterId}.
        slots:
          dbcId: requestBody.dbcId
          clusterId: requestBody.clusterId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/healthCheck'].post
  update:
    x-apievangelist-phrasing:
      intent: Check the Data Warehouse API is healthy
      effect: read
      questions:
      - Is the Cloudera Data Warehouse API up?
      - Can I ping the DW service to confirm it's responding?
      instructions:
      - text: Run a health check on the Data Warehouse API.
      - text: Ping the DW service and tell me if it's responding.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/createBackup'].post
  update:
    x-apievangelist-phrasing:
      intent: Take an on-demand data warehouse backup
      effect: write
      questions:
      - How do I back up the data warehouse including Kubernetes objects and persistent volumes?
      - Can I limit an on-demand backup to certain namespaces?
      instructions:
      - text: Create a data warehouse backup named {backupName}.
        slots:
          backupName: requestBody.backupName
      - text: Back up namespaces {namespaceNames} now as {backupName}.
        slots:
          namespaceNames: requestBody.namespaceNames
          backupName: requestBody.backupName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/deleteBackup'].post
  update:
    x-apievangelist-phrasing:
      intent: Delete a data warehouse backup
      effect: destructive
      questions:
      - How do I remove an old data warehouse backup?
      - Does deleting a backup happen immediately?
      instructions:
      - text: Delete data warehouse backup {backupCrn}.
        slots:
          backupCrn: requestBody.backupCrn
      - text: Remove the backup {backupCrn} permanently.
        slots:
          backupCrn: requestBody.backupCrn
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/describeBackup'].post
  update:
    x-apievangelist-phrasing:
      intent: Get details of a data warehouse backup
      effect: read
      questions:
      - Did my data warehouse backup complete successfully?
      - What does a particular backup contain and when was it taken?
      instructions:
      - text: Describe data warehouse backup {backupCrn}.
        slots:
          backupCrn: requestBody.backupCrn
      - text: Show the state of backup {backupCrn}.
        slots:
          backupCrn: requestBody.backupCrn
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/restoreBackup'].post
  update:
    x-apievangelist-phrasing:
      intent: Restore the data warehouse from a backup
      effect: write
      questions:
      - How do I roll the data warehouse back to an earlier backup?
      - Can I restore only some namespaces from a backup?
      instructions:
      - text: Restore the data warehouse from backup {backupCrn}.
        slots:
          backupCrn: requestBody.backupCrn
      - text: Restore namespaces {namespaceNames} from backup {backupCrn} with rebuild {rebuild}.
        slots:
          namespaceNames: requestBody.namespaceNames
          backupCrn: requestBody.backupCrn
          rebuild: requestBody.rebuild
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/describeRestore'].post
  update:
    x-apievangelist-phrasing:
      intent: Check a data warehouse restore
      effect: read
      questions:
      - Has my data warehouse restore finished?
      - What happened during a particular restore operation?
      instructions:
      - text: Describe restore {restoreCrn}.
        slots:
          restoreCrn: requestBody.restoreCrn
      - text: Show the progress of data warehouse restore {restoreCrn}.
        slots:
          restoreCrn: requestBody.restoreCrn
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/listBackupEntities'].post
  update:
    x-apievangelist-phrasing:
      intent: List what can be included in a backup
      effect: read
      questions:
      - Which namespaces and entities can I include in a data warehouse backup?
      - What parts of the data warehouse are eligible for backup?
      instructions:
      - text: List the potential backup entities for the data warehouse.
      - text: Show which namespaces I could back up.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/listBackups'].post
  update:
    x-apievangelist-phrasing:
      intent: List data warehouse backups
      effect: read
      questions:
      - What backups exist for my data warehouse?
      - Can I include automatic backups or filter backups by job state?
      instructions:
      - text: List my data warehouse backups.
      - text: Show backups in state {jobStates}, including automatic ones set to {includeAutomaticBackups}.
        slots:
          jobStates: requestBody.jobStates
          includeAutomaticBackups: requestBody.includeAutomaticBackups
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/listRestores'].post
  update:
    x-apievangelist-phrasing:
      intent: List data warehouse restores
      effect: read
      questions:
      - Which restore operations have been run on my data warehouse?
      - Can I see all restores that came from one backup?
      instructions:
      - text: List data warehouse restores.
      - text: Show the restores made from backup {backupCrn}.
        slots:
          backupCrn: requestBody.backupCrn
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/getLogs'].post
  update:
    x-apievangelist-phrasing:
      intent: Get logs for a backup or restore job
      effect: read
      questions:
      - Where can I read the logs of a backup or restore job?
      - Why did my data warehouse backup job fail?
      instructions:
      - text: Get the job logs for {crn}.
        slots:
          crn: requestBody.crn
      - text: Show me the log output of job {crn}.
        slots:
          crn: requestBody.crn
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/listResourceTemplates'].post
  update:
    x-apievangelist-phrasing:
      intent: List resource allocation templates
      effect: read
      questions:
      - What default CPU and memory templates does CDW offer?
      - Which resource templates can I assign to warehouses and catalogs?
      instructions:
      - text: List the resource allocation templates.
      - text: Show the predefined CPU and memory templates.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/createResourceTemplate'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a resource allocation template
      effect: write
      questions:
      - Can I define my own CPU and memory template for Virtual Warehouses?
      - How do I create a custom resource template for a given entity type?
      instructions:
      - text: Create a resource template named {name} for {entityType} with resources {resources}.
        slots:
          name: requestBody.name
          entityType: requestBody.entityType
          resources: requestBody.resources
      - text: Add a custom CPU and memory template {name} described as {description}.
        slots:
          name: requestBody.name
          description: requestBody.description
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/updateResourceTemplate'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a resource allocation template
      effect: write
      questions:
      - Can I change the CPU or memory values in an existing resource template?
      - How do I rename a resource template I already made?
      instructions:
      - text: Update resource template {templateId} with resources {resources}.
        slots:
          templateId: requestBody.templateId
          resources: requestBody.resources
      - text: Rename existing template {templateId} to {name}.
        slots:
          templateId: requestBody.templateId
          name: requestBody.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/dw/deleteResourceTemplate'].post
  update:
    x-apievangelist-phrasing:
      intent: Delete a resource allocation template
      effect: destructive
      questions:
      - How do I remove a custom resource template?
      - Can I delete one specific version of a resource template?
      instructions:
      - text: Delete resource template {templateId}.
        slots:
          templateId: requestBody.templateId
      - text: Remove version {templateVersion} of template {templateId}.
        slots:
          templateVersion: requestBody.templateVersion
          templateId: requestBody.templateId
      method: generated
      generated: '2026-10-01'