# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Amazon Neptune Neptune Analytics Graphs API
  version: 1.0.0
extends: openapi/amazon-neptune-graphs-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: 6
- target: $.paths['/graphs'].get
  update:
    x-apievangelist-phrasing:
      intent: List Neptune Analytics graphs
      effect: read
      questions:
      - Which Neptune Analytics graphs do I have in my account?
      - Can I page through my analytics graphs a few at a time?
      instructions:
      - text: List my Neptune Analytics graphs.
      - text: Show my analytics graphs {max} per page.
        slots:
          max: query.maxResults
      method: generated
      generated: '2026-10-01'
- target: $.paths['/graphs'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a Neptune Analytics graph
      effect: write
      questions:
      - How do I create an empty Neptune Analytics graph for openCypher and vector search?
      - Can I enable vector search and set provisioned memory on a new graph?
      - Is public connectivity optional when I create an analytics graph?
      instructions:
      - text: Create analytics graph {name} with {memory} provisioned memory.
        slots:
          name: requestBody.graphName
          memory: requestBody.provisionedMemory
      - text: Create graph {name} with {memory} memory and vector search config {vector}.
        slots:
          name: requestBody.graphName
          memory: requestBody.provisionedMemory
          vector: requestBody.vectorSearchConfiguration
      method: generated
      generated: '2026-10-01'
- target: $.paths['/graphs/{graphIdentifier}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get details of a Neptune Analytics graph
      effect: read
      questions:
      - What is the status and memory size of one of my analytics graphs?
      - Can I see the endpoint and settings for a specific graph?
      instructions:
      - text: Show details for analytics graph {graph}.
        slots:
          graph: path.graphIdentifier
      - text: Check the status of graph {graph}.
        slots:
          graph: path.graphIdentifier
      method: generated
      generated: '2026-10-01'
- target: $.paths['/graphs/{graphIdentifier}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Neptune Analytics graph
      effect: destructive
      questions:
      - Can I delete an analytics graph without taking a final snapshot?
      - Why would deleting a graph fail if deletion protection is on?
      instructions:
      - text: Delete analytics graph {graph}, setting skip-snapshot to {skip}.
        slots:
          graph: path.graphIdentifier
          skip: query.skipSnapshot
      - text: Delete graph {graph}, choosing whether to skip the snapshot ({skip}).
        slots:
          graph: path.graphIdentifier
          skip: query.skipSnapshot
      method: generated
      generated: '2026-10-01'
- target: $.paths['/graphs/{graphIdentifier}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a Neptune Analytics graph's settings
      effect: write
      questions:
      - How do I change the provisioned memory of an existing analytics graph?
      - Can I turn deletion protection on for a graph after it is created?
      instructions:
      - text: Change graph {graph} to {memory} provisioned memory.
        slots:
          graph: path.graphIdentifier
          memory: requestBody.provisionedMemory
      - text: Turn on deletion protection for graph {graph}.
        slots:
          graph: path.graphIdentifier
      method: generated
      generated: '2026-10-01'
- target: $.paths['/graphs/{graphIdentifier}/reset'].put
  update:
    x-apievangelist-phrasing:
      intent: Wipe all data from an analytics graph
      effect: destructive
      questions:
      - Can I empty all nodes and edges from a graph but keep the graph itself?
      - What does resetting a Neptune Analytics graph preserve?
      instructions:
      - text: Reset graph {graph} and clear all its nodes and edges.
        slots:
          graph: path.graphIdentifier
      - text: Empty graph {graph} with clean data set to {clean}.
        slots:
          graph: path.graphIdentifier
          clean: requestBody.performCleanData
      method: generated
      generated: '2026-10-01'