# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Vault Manager Storage Nodes API
  version: 1.0.0
extends: openapi/acronis-storage-nodes-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: 4
- target: $.paths['/storage_nodes'].get
  update:
    x-apievangelist-phrasing:
      intent: List registered storage nodes
      effect: read
      questions:
      - Which storage nodes are registered in my on-premises install?
      - How do I see all storage nodes?
      instructions:
      - text: List registered storage nodes.
      - text: Show every on-premises storage node.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/storage_nodes'].post
  update:
    x-apievangelist-phrasing:
      intent: Register a storage node
      effect: write
      questions:
      - How do I add a new storage node to an on-premises deployment?
      - What credentials are needed to register a storage node host?
      instructions:
      - text: Register storage node on host {host}.
        slots:
          host: requestBody.host
      - text: Add storage node {host} with username {username}.
        slots:
          host: requestBody.host
          username: requestBody.username
      method: generated
      generated: '2026-09-26'
- target: $.paths['/storage_nodes/{storageNodeID}/checkuser'].post
  update:
    x-apievangelist-phrasing:
      intent: Test credentials on a storage node
      effect: read
      questions:
      - Can a given user account access a storage node?
      - How do I verify storage node credentials before using them?
      instructions:
      - text: Check whether {uri} can access storage node {storageNodeID}.
        slots:
          uri: requestBody.uri
          storageNodeID: path.storageNodeID
      - text: Verify user access to storage node {storageNodeID} in session {session_id}.
        slots:
          storageNodeID: path.storageNodeID
          session_id: requestBody.session_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/storage_nodes/{storageNodeID}/check_location'].post
  update:
    x-apievangelist-phrasing:
      intent: Find a vault by path on a storage node
      effect: read
      questions:
      - Is there already a vault at a given path on a storage node?
      - How do I locate a vault on a storage node from its location?
      instructions:
      - text: Find the vault at {uri_to_find} on storage node {storageNodeID}.
        slots:
          uri_to_find: requestBody.uri_to_find
          storageNodeID: path.storageNodeID
      - text: Look up a vault on storage node {storageNodeID} by path {uri_to_find}.
        slots:
          storageNodeID: path.storageNodeID
          uri_to_find: requestBody.uri_to_find
      method: generated
      generated: '2026-09-26'