API Evangelist conversational phrasing for Elastic Cloud Enterprise Deployments API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Elastic Cloud Enterprise Deployments API
  version: 1.0.0
extends: openapi/elk-stack-deployments-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 72
- target: $.paths['/deployments'].get
  update:
    x-apievangelist-phrasing:
      intent: List all deployments
      effect: read
      questions:
      - What deployments do I have running in Elastic Cloud Enterprise?
      - Can I see every deployment in my environment at once?
      instructions:
      - text: List all my deployments.
      - text: Show me every deployment I currently have.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deployments'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a new deployment
      effect: write
      questions:
      - How do I spin up a new Elastic deployment?
      - Can I build a new deployment from a deployment template?
      - Is there a way to dry-run a deployment definition without actually creating it?
      instructions:
      - text: Create a new deployment named {name} from template {template_id}.
        slots:
          name: requestBody.name
          template_id: query.template_id
      - text: Create a deployment called {name} on stack version {version}.
        slots:
          name: requestBody.name
          version: requestBody.version
      - text: Validate a new deployment definition named {name} without creating it.
        slots:
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deployments/_resync'].post
  update:
    x-apievangelist-phrasing:
      intent: Resync the search index for all deployments
      effect: write
      questions:
      - How do I rebuild the deployment search index across every deployment?
      - Can I skip deployments whose indexed version already matches during a full resync?
      instructions:
      - text: Resynchronize the search index for all deployments.
      - text: Resync every deployment's index entry, skipping ones already on the matching version.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deployments/_search'].post
  update:
    x-apievangelist-phrasing:
      intent: Search deployments with a query
      effect: read
      questions:
      - How do I find deployments that match a specific query?
      - Can I page and sort through deployment search results?
      instructions:
      - text: Search my deployments using query {query}.
        slots:
          query: requestBody.query
      - text: Find deployments matching {query} and return the first {size} results.
        slots:
          query: requestBody.query
          size: requestBody.size
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deployments/eligible-remote-clusters'].post
  update:
    x-apievangelist-phrasing:
      intent: Find deployments eligible as remote clusters
      effect: read
      questions:
      - Which deployments can serve as remote clusters for a given Elasticsearch version?
      - How do I find candidate remote clusters compatible with version 8.x across all deployments?
      instructions:
      - text: List deployments with remote clusters eligible for version {version}.
        slots:
          version: query.version
      - text: Find remote cluster candidates compatible with Elasticsearch {version} matching {query}.
        slots:
          version: query.version
          query: requestBody.query
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deployments/{deployment_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a deployment's details
      effect: read
      questions:
      - How do I look up the full details of one deployment?
      - Can I include plan history and instance metrics when fetching a deployment?
      instructions:
      - text: Get details for deployment {deployment_id}.
        slots:
          deployment_id: path.deployment_id
      - text: Show deployment {deployment_id} including its plan history.
        slots:
          deployment_id: path.deployment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deployments/{deployment_id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a deployment's configuration
      effect: write
      questions:
      - How do I change the configuration of an existing deployment?
      - Can I rename a deployment and prune resources I left out of the update?
      instructions:
      - text: Rename deployment {deployment_id} to {name}.
        slots:
          deployment_id: path.deployment_id
          name: requestBody.name
      - text: Update deployment {deployment_id} with prune orphans set to {prune_orphans}.
        slots:
          deployment_id: path.deployment_id
          prune_orphans: requestBody.prune_orphans
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deployments/{deployment_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a deployment and its resources
      effect: destructive
      questions:
      - How do I permanently delete a deployment along with all its resources?
      - Can I remove a deployment I no longer need entirely?
      instructions:
      - text: Delete deployment {deployment_id} and all of its resources.
        slots:
          deployment_id: path.deployment_id
      - text: Permanently remove deployment {deployment_id}.
        slots:
          deployment_id: path.deployment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deployments/{deployment_id}/_restore'].post
  update:
    x-apievangelist-phrasing:
      intent: Restore a shut-down deployment
      effect: write
      questions:
      - How do I bring back a whole deployment that was shut down?
      - Can I restore every resource in a deployment from the latest snapshot?
      instructions:
      - text: Restore shut-down deployment {deployment_id}.
        slots:
          deployment_id: path.deployment_id
      - text: Restore all resources in deployment {deployment_id} from snapshot.
        slots:
          deployment_id: path.deployment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deployments/{deployment_id}/_resync'].post
  update:
    x-apievangelist-phrasing:
      intent: Resync the search index for one deployment
      effect: write
      questions:
      - How do I force a single deployment's search index entry to resynchronize now?
      - Can I refresh the indexed record for just one deployment?
      instructions:
      - text: Resynchronize the search index for deployment {deployment_id}.
        slots:
          deployment_id: path.deployment_id
      - text: Immediately resync deployment {deployment_id}.
        slots:
          deployment_id: path.deployment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deployments/{deployment_id}/_shutdown'].post
  update:
    x-apievangelist-phrasing:
      intent: Shut down an entire deployment
      effect: destructive
      questions:
      - How do I shut down every resource in a deployment?
      - Can I hide a deployment when I shut it down?
      instructions:
      - text: Shut down deployment {deployment_id}.
        slots:
          deployment_id: path.deployment_id
      - text: Shut down all resources in deployment {deployment_id} and hide it.
        slots:
          deployment_id: path.deployment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deployments/{deployment_id}/apm/{ref_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a deployment's APM resource info
      effect: read
      questions:
      - How do I see the details of the APM resource in my deployment?
      - Can I view the APM resource's plan and settings?
      instructions:
      - text: Get APM resource {ref_id} in deployment {deployment_id}.
        slots:
          ref_id: path.ref_id
          deployment_id: path.deployment_id
      - text: Show the APM resource {ref_id} settings for deployment {deployment_id}.
        slots:
          ref_id: path.ref_id
          deployment_id: path.deployment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deployments/{deployment_id}/apm/{ref_id}/_reset-token'].post
  update:
    x-apievangelist-phrasing:
      intent: Reset an APM resource's secret token
      effect: write
      questions:
      - How do I rotate the APM secret token for a deployment?
      - Can I generate a new secret token for my APM server?
      instructions:
      - text: Reset the APM secret token for resource {ref_id} in deployment {deployment_id}.
        slots:
          ref_id: path.ref_id
          deployment_id: path.deployment_id
      - text: Rotate the APM token on deployment {deployment_id}, resource {ref_id}.
        slots:
          ref_id: path.ref_id
          deployment_id: path.deployment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deployments/{deployment_id}/appsearch/{ref_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a deployment's App Search resource info
      effect: read
      questions:
      - How do I see the details of the App Search resource in a deployment?
      - Can I include the plan log for my App Search resource?
      instructions:
      - text: Get App Search resource {ref_id} in deployment {deployment_id}.
        slots:
          ref_id: path.ref_id
          deployment_id: path.deployment_id
      - text: Show App Search resource {ref_id} of deployment {deployment_id} with plan logs.
        slots:
          ref_id: path.ref_id
          deployment_id: path.deployment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deployments/{deployment_id}/appsearch/{ref_id}/read_only_mode'].get
  update:
    x-apievangelist-phrasing:
      intent: Check App Search read-only status
      effect: read
      questions:
      - Is my App Search resource currently in read-only mode?
      - How can I check whether App Search writes are blocked?
      instructions:
      - text: Check whether App Search resource {ref_id} in deployment {deployment_id} is read-only.
        slots:
          ref_id: path.ref_id
          deployment_id: path.deployment_id
      - text: Get the read-only status of App Search on deployment {deployment_id}, resource {ref_id}.
        slots:
          ref_id: path.ref_id
          deployment_id: path.deployment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deployments/{deployment_id}/appsearch/{ref_id}/read_only_mode'].put
  update:
    x-apievangelist-phrasing:
      intent: Turn App Search read-only mode on or off
      effect: write
      questions:
      - How do I put App Search into read-only mode?
      - Can I switch App Search back to accepting writes?
      instructions:
      - text: Set App Search read-only mode to {enabled} for resource {ref_id} in deployment {deployment_id}.
        slots:
          enabled: requestBody.enabled
          ref_id: path.ref_id
          deployment_id: path.deployment_id
      - text: Enable read-only mode on App Search resource {ref_id} of deployment {deployment_id}.
        slots:
          ref_id: path.ref_id
          deployment_id: path.deployment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deployments/{deployment_id}/certificate-authority'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a deployment's certificate authority
      effect: read
      questions:
      - Which certificate authority signs my deployment's certificates?
      - How do I download the CA certificate for a deployment?
      instructions:
      - text: Get the certificate authority for deployment {deployment_id}.
        slots:
          deployment_id: path.deployment_id
      - text: Fetch the CA used to sign certificates on deployment {deployment_id}.
        slots:
          deployment_id: path.deployment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deployments/{deployment_id}/elasticsearch/{ref_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a deployment's Elasticsearch resource info
      effect: read
      questions:
      - How do I see the details of the Elasticsearch cluster inside a deployment?
      - Can I include system alerts and security settings for the Elasticsearch resource?
      instructions:
      - text: Get Elasticsearch resource {ref_id} in deployment {deployment_id}.
        slots:
          ref_id: path.ref_id
          deployment_id: path.deployment_id
      - text: Show system alerts for Elasticsearch resource {ref_id} of deployment {deployment_id}.
        slots:
          ref_id: path.ref_id
          deployment_id: path.deployment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deployments/{deployment_id}/elasticsearch/{ref_id}/_enable-ccr'].post
  update:
    x-apievangelist-phrasing:
      intent: Migrate Elasticsearch and Kibana to enable CCR
      effect: write
      questions:
      - How do I enable cross-cluster replication on an existing deployment?
      - Can I validate a CCR migration before running it?
      instructions:
      - text: Enable cross-cluster replication for Elasticsearch resource {ref_id} in deployment {deployment_id}.
        slots:
          ref_id: path.ref_id
          deployment_id: path.deployment_id
      - text: Validate the CCR migration for deployment {deployment_id}, resource {ref_id}, without applying it.
        slots:
          ref_id: path.ref_id
          deployment_id: path.deployment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deployments/{deployment_id}/elasticsearch/{ref_id}/_enable-ilm'].post
  update:
    x-apievangelist-phrasing:
      intent: Migrate an Elasticsearch resource to ILM
      effect: write
      questions:
      - How do I switch an Elasticsearch cluster over to index lifecycle management?
      - Which index patterns do I need to supply when migrating to ILM?
      instructions:
      - text: Migrate Elasticsearch resource {ref_id} in deployment {deployment_id} to ILM for index patterns {index_patterns}.
        slots:
          ref_id: path.ref_id
          deployment_id: path.deployment_id
          index_patterns: requestBody.index_patterns
      - text: Turn on index lifecycle management for deployment {deployment_id} resource {ref_id} covering {index_patterns}.
        slots:
          ref_id: path.ref_id
          deployment_id: path.deployment_id
          index_patterns: requestBody.index_patterns
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deployments/{deployment_id}/elasticsearch/{ref_id}/_enable-slm'].post
  update:
    x-apievangelist-phrasing:
      intent: Migrate an Elasticsearch resource to SLM
      effect: write
      questions:
      - How do I move a cluster's snapshots onto snapshot lifecycle management?
      - Can I check that an SLM migration would succeed before doing it?
      instructions:
      - text: Migrate Elasticsearch resource {ref_id} in deployment {deployment_id} to SLM.
        slots:
          ref_id: path.ref_id
          deployment_id: path.deployment_id
      - text: Validate switching deployment {deployment_id} resource {ref_id} to snapshot lifecycle management.
        slots:
          ref_id: path.ref_id
          deployment_id: path.deployment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deployments/{deployment_id}/elasticsearch/{ref_id}/_reset-password'].post
  update:
    x-apievangelist-phrasing:
      intent: Reset the elastic superuser password
      effect: write
      questions:
      - I lost the elastic user password — how do I reset it?
      - Can I generate a new password for the built-in elastic superuser?
      instructions:
      - text: Reset the elastic user password for resource {ref_id} in deployment {deployment_id}.
        slots:
          ref_id: path.ref_id
          deployment_id: path.deployment_id
      - text: Generate a new elastic superuser password on deployment {deployment_id}, cluster {ref_id}.
        slots:
          ref_id: path.ref_id
          deployment_id: path.deployment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deployments/{deployment_id}/elasticsearch/{ref_id}/_restart'].post
  update:
    x-apievangelist-phrasing:
      intent: Restart a deployment's Elasticsearch cluster
      effect: write
      questions:
      - How do I restart the Elasticsearch cluster in a deployment?
      - Can I restart Elasticsearch one availability zone at a time?
      - Will restarting cancel a pending plan on the cluster?
      instructions:
      - text: Restart Elasticsearch resource {ref_id} in deployment {deployment_id}.
        slots:
          ref_id: path.ref_id
          deployment_id: path.deployment_id
      - text: Restart Elasticsearch {ref_id} on deployment {deployment_id} grouped by {group_attribute}.
        slots:
          ref_id: path.ref_id
          deployment_id: path.deployment_id
          group_attribute: query.group_attribute
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deployments/{deployment_id}/elasticsearch/{ref_id}/_shutdown'].post
  update:
    x-apievangelist-phrasing:
      intent: Shut down a deployment's Elasticsearch cluster
      effect: destructive
      questions:
      - How do I shut down only the Elasticsearch cluster of a deployment?
      - Can I skip the snapshot when shutting down Elasticsearch?
      instructions:
      - text: Shut down Elasticsearch resource {ref_id} in deployment {deployment_id}.
        slots:
          ref_id: path.ref_id
          deployment_id: path.deployment_id
      - text: Shut down Elasticsearch {ref_id} on deployment {deployment_id} without taking a snapshot.
        slots:
          ref_id: path.ref_id
          deployment_id: path.deployment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deployments/{deployment_id}/elasticsearch/{ref_id}/eligible-remote-clusters'].post
  update:
    x-apievangelist-phrasing:
      intent: List remote clusters eligible for one cluster
      effect: read
      questions:
      - Which deployments could I connect as remote clusters to this specific Elasticsearch cluster?
      - How do I find remote cluster candidates for my existing cluster?
      instructions:
      - text: List eligible remote clusters for Elasticsearch resource {ref_id} in deployment {deployment_id}.
        slots:
          ref_id: path.ref_id
          deployment_id: path.deployment_id
      - text: Find deployments that can be remotes for cluster {ref_id} on deployment {deployment_id}.
        slots:
          ref_id: path.ref_id
          deployment_id: path.deployment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deployments/{deployment_id}/elasticsearch/{ref_id}/instances/{instance_ids}/_move'].post
  update:
    x-apievangelist-phrasing:
      intent: Move Elasticsearch instances to another allocator
      effect: write
      questions:
      - How do I move Elasticsearch instances off an allocator?
      - Can I force-move instances even when they are down?
      instructions:
      - text: Move instances {instance_ids} of Elasticsearch resource {ref_id} in deployment {deployment_id} to another allocator.
        slots:
          instance_ids: path.instance_ids
          ref_id: path.ref_id
          deployment_id: path.deployment_id
      - text: Force-move Elasticsearch instances {instance_ids} on deployment {deployment_id}, resource {ref_id}.
        slots:
          instance_ids: path.instance_ids
          ref_id: path.ref_id
          deployment_id: path.deployment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deployments/{deployment_id}/elasticsearch/{ref_id}/keystore'].get
  update:
    x-apievangelist-phrasing:
      intent: List Elasticsearch keystore entries
      effect: read
      questions:
      - What secure settings are stored in my Elasticsearch keystore?
      - Can I see keystore keys without exposing their values?
      instructions:
      - text: List keystore entries for Elasticsearch resource {ref_id} in deployment {deployment_id}.
        slots:
          ref_id: path.ref_id
          deployment_id: path.deployment_id
      - text: Show the keystore fields on deployment {deployment_id}, cluster {ref_id}.
        slots:
          ref_id: path.ref_id
          deployment_id: path.deployment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deployments/{deployment_id}/elasticsearch/{ref_id}/keystore'].patch
  update:
    x-apievangelist-phrasing:
      intent: Add or remove Elasticsearch keystore secrets
      effect: write
      questions:
      - How do I add a secure setting to the Elasticsearch keystore?
      - Can I remove a secret from the keystore of my cluster?
      instructions:
      - text: Add secrets {secrets} to the keystore of Elasticsearch {ref_id} in deployment {deployment_id}.
        slots:
          secrets: requestBody.secrets
          ref_id: path.ref_id
          deployment_id: path.deployment_id
      - text: Update the keystore on deployment {deployment_id}, cluster {ref_id}, with {secrets}.
        slots:
          secrets: requestBody.secrets
          ref_id: path.ref_id
          deployment_id: path.deployment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deployments/{deployment_id}/elasticsearch/{ref_id}/remote-clusters'].get
  update:
    x-apievangelist-phrasing:
      intent: List certificate-based remote clusters
      effect: read
      questions:
      - Which certificate-based remote clusters are configured on my cluster?
      - How do I see the remote clusters already linked to an Elasticsearch resource?
      instructions:
      - text: List certificate-based remote clusters for Elasticsearch {ref_id} in deployment {deployment_id}.
        slots:
          ref_id: path.ref_id
          deployment_id: path.deployment_id
      - text: Show configured remote clusters on deployment {deployment_id}, resource {ref_id}.
        slots:
          ref_id: path.ref_id
          deployment_id: path.deployment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deployments/{deployment_id}/elasticsearch/{ref_id}/remote-clusters'].put
  update:
    x-apievangelist-phrasing:
      intent: Set certificate-based remote clusters
      effect: write
      questions:
      - How do I configure certificate-based remote clusters for cross-cluster search?
      - Does setting remote clusters replace the existing list?
      instructions:
      - text: Set remote clusters {resources} on Elasticsearch {ref_id} in deployment {deployment_id}.
        slots:
          resources: requestBody.resources
          ref_id: path.ref_id
          deployment_id: path.deployment_id
      - text: Overwrite the remote cluster list for deployment {deployment_id}, resource {ref_id}, with {resources}.
        slots:
          resources: requestBody.resources
          ref_id: path.ref_id
          deployment_id: path.deployment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deployments/{deployment_id}/elasticsearch/{ref_id}/snapshot/repository'].get
  update:
    x-apievangelist-phrasing:
      intent: List attached snapshot repositories
      effect: read
      questions:
      - Which other deployments' snapshot repositories can my cluster read from?
      - How do I see snapshot repositories linked to a deployment?
      instructions:
      - text: List attached snapshot repositories for Elasticsearch {ref_id} in deployment {deployment_id}.
        slots:
          ref_id: path.ref_id
          deployment_id: path.deployment_id
      - text: Show linked snapshot repositories on deployment {deployment_id}, cluster {ref_id}.
        slots:
          ref_id: path.ref_id
          deployment_id: path.deployment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deployments/{deployment_id}/elasticsearch/{ref_id}/snapshot/repository'].post
  update:
    x-apievangelist-phrasing:
      intent: Link another deployment's snapshot repository
      effect: write
      questions:
      - How do I let my cluster access snapshots from another deployment?
      - Can I attach a source deployment's snapshots to a new cluster?
      instructions:
      - text: Attach snapshots from deployment {source_deployment_id} to Elasticsearch {ref_id} in deployment {deployment_id}.
        slots:
          source_deployment_id: requestBody.source_deployment_id
          ref_id: path.ref_id
          deployment_id: path.deployment_id
      - text: Create a snapshot repository link on deployment {deployment_id}, resource {ref_id}, sourced from {source_deployment_id}.
        slots:
          source_deployment_id: requestBody.source_deployment_id
          ref_id: path.ref_id
          deployment_id: path.deployment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deployments/{deployment_id}/elasticsearch/{ref_id}/snapshot/repository/{repository_name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove an attached snapshot repository
      effect: destructive
      questions:
      - How do I detach a snapshot repository from my deployment?
      - Can I remove a linked repository that searchable snapshots still use?
      instructions:
      - text: Remove snapshot repository {repository_name} from Elasticsearch {ref_id} in deployment {deployment_id}.
        slots:
          repository_name: path.repository_name
          ref_id: path.ref_id
          deployment_id: path.deployment_id
      - text: Detach repository {repository_name} from deployment {deployment_id}, cluster {ref_id}.
        slots:
          repository_name: path.repository_name
          ref_id: path.ref_id
          deployment_id: path.deployment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deployments/{deployment_id}/elasticsearch/{ref_id}/tiers'].get
  update:
    x-apievangelist-phrasing:
      intent: Get Elasticsearch tier sizes and zones
      effect: read
      questions:
      - How much memory and how many zones does each data tier have?
      - What sizes are available for my hot, warm and cold tiers?
      instructions:
      - text: Show the Elasticsearch tiers for resource {ref_id} in deployment {deployment_id}.
        slots:
          ref_id: path.ref_id
          deployment_id: path.deployment_id
      - text: Get tier memory sizes and zone counts on deployment {deployment_id}, cluster {ref_id}.
        slots:
          ref_id: path.ref_id
          deployment_id: path.deployment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deployments/{deployment_id}/elasticsearch/{ref_id}/tiers'].patch
  update:
    x-apievangelist-phrasing:
      intent: Resize Elasticsearch data tiers
      effect: write
      questions:
      - How do I scale up the hot tier of my cluster?
      - Can I change the zone count of the warm tier?
      instructions:
      - text: Resize the hot tier of Elasticsearch {ref_id} in deployment {deployment_id} to {hot_content}.
        slots:
          hot_content: requestBody.hot_content
          ref_id: path.ref_id
          deployment_id: path.deployment_id
      - text: Set the warm tier on deployment {deployment_id}, cluster {ref_id}, to {warm}.
        slots:
          warm: requestBody.warm
          ref_id: path.ref_id
          deployment_id: path.deployment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deployments/{deployment_id}/enterprise_search/{ref_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a deployment's Enterprise Search resource info
      effect: read
      questions:
      - Where can I inspect the Enterprise Search component running in my deployment?
      - Can I view the Enterprise Search plan defaults?
      instructions:
      - text: Get Enterprise Search resource {ref_id} in deployment {deployment_id}.
        slots:
          ref_id: path.ref_id
          deployment_id: path.deployment_id
      - text: Show Enterprise Search {ref_id} plan defaults for deployment {deployment_id}.
        slots:
          ref_id: path.ref_id
          deployment_id: path.deployment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deployments/{deployment_id}/heap_dumps'].get
  update:
    x-apievangelist-phrasing:
      intent: List heap dumps for a deployment
      effect: read
      questions:
      - Which heap dumps exist or are being captured for my deployment?
      - How do I check the progress of an on-demand heap dump?
      instructions:
      - text: List heap dumps for deployment {deployment_id}.
        slots:
          deployment_id: path.deployment_id
      - text: Show in-progress heap dump captures on deployment {deployment_id}.
        slots:
          deployment_id: path.deployment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deployments/{deployment_id}/integrations_server/{ref_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a deployment's Integrations Server info
      effect: read
      questions:
      - How do I see the details of the Integrations Server in my deployment?
      - Can I view the Integrations Server's current settings?
      instructions:
      - text: Get Integrations Server resource {ref_id} in deployment {deployment_id}.
        slots:
          ref_id: path.ref_id
          deployment_id: path.deployment_id
      - text: Show Integrations Server {ref_id} metadata for deployment {deployment_id}.
        slots:
          ref_id: path.ref_id
          deployment_id: path.deployment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deployments/{deployment_id}/kibana/{ref_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a deployment's Kibana resource info
      effect: read
      questions:
      - How do I see the details of the Kibana instance in a deployment?
      - Can I view Kibana's plan history for a deployment?
      instructions:
      - text: Get Kibana resource {ref_id} in deployment {deployment_id}.
        slots:
          ref_id: path.ref_id
          deployment_id: path.deployment_id
      - text: Show Kibana {ref_id} plan history on deployment {deployment_id}.
        slots:
          ref_id: path.ref_id
          deployment_id: path.deployment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deployments/{deployment_id}/migrate_template'].get
  update:
    x-apievangelist-phrasing:
      intent: Build a request to switch deployment template
      effect: read
      questions:
      - How do I move a deployment to a different deployment template?
      - What would the update request look like to migrate to another template?
      instructions:
      - text: Build the migration request to move deployment {deployment_id} to template {template_id}.
        slots:
          deployment_id: path.deployment_id
          template_id: query.template_id
      - text: Preview migrating deployment {deployment_id} onto template {template_id}.
        slots:
          deployment_id: path.deployment_id
          template_id: query.template_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deployments/{deployment_id}/tags'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a deployment's tags
      effect: read
      questions:
      - What tags are on my deployment?
      - How can I read the labels attached to a deployment?
      instructions:
      - text: Get the tags for deployment {deployment_id}.
        slots:
          deployment_id: path.deployment_id
      - text: Show the labels on deployment {deployment_id}.
        slots:
          deployment_id: path.deployment_id
      method: generated
      generated: '2026-09-26'


# --- truncated at 32 KB (61 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/elk-stack/refs/heads/main/overlays/elk-stack-deployments-api-phrasing-overlay.yaml