# 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 Status API
  version: 1.0.0
extends: openapi/amazon-neptune-status-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: 14
- target: $.paths['/status'].get
  update:
    x-apievangelist-phrasing:
      intent: Check Neptune instance health
      effect: read
      questions:
      - Is my Neptune instance healthy and what engine version is it running?
      - Which role, writer or reader, does this Neptune instance hold?
      instructions:
      - text: Check the health of my Neptune instance.
      - text: Show the engine version and cluster role of this instance.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/propertygraph/statistics'].get
  update:
    x-apievangelist-phrasing:
      intent: Get property graph statistics
      effect: read
      questions:
      - How many nodes and edges are in my property graph?
      - What does the label distribution of my Gremlin data look like?
      instructions:
      - text: Show property graph statistics.
      - text: Report node and edge counts for my property graph.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/propertygraph/statistics'].post
  update:
    x-apievangelist-phrasing:
      intent: Start or delete property graph statistics
      effect: write
      questions:
      - Can I trigger a refresh of the property graph statistics?
      - How do I delete the statistics generated for my property graph?
      instructions:
      - text: Set property graph statistics generation to mode {mode}.
        slots:
          mode: requestBody.mode
      - text: Regenerate my property graph statistics now.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/sparql/statistics'].get
  update:
    x-apievangelist-phrasing:
      intent: Get RDF graph statistics
      effect: read
      questions:
      - How many triples are stored in my RDF graph?
      - What does the predicate distribution of my SPARQL data look like?
      instructions:
      - text: Show SPARQL RDF statistics.
      - text: Report triple counts for my RDF data.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/sparql/statistics'].post
  update:
    x-apievangelist-phrasing:
      intent: Start or delete RDF statistics
      effect: write
      questions:
      - Can I trigger a refresh of the RDF statistics?
      - How do I delete the statistics generated for my RDF data?
      instructions:
      - text: Set RDF statistics generation to mode {mode}.
        slots:
          mode: requestBody.mode
      - text: Regenerate my SPARQL statistics now.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/gremlin/status'].get
  update:
    x-apievangelist-phrasing:
      intent: List all running Gremlin queries
      effect: read
      questions:
      - Which Gremlin queries are running or waiting right now?
      - Can I see the query strings and execution stats of active Gremlin queries?
      instructions:
      - text: Show all running and waiting Gremlin queries.
      - text: List active Gremlin queries with their execution statistics.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/gremlin/status/{queryId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check one Gremlin query's status
      effect: read
      questions:
      - Is a specific Gremlin query still running?
      - What execution statistics does a given Gremlin query have?
      instructions:
      - text: Get the status of Gremlin query {query_id}.
        slots:
          query_id: path.queryId
      - text: Show stats for Gremlin query {query_id}.
        slots:
          query_id: path.queryId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/gremlin/status/{queryId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Cancel a Gremlin query
      effect: destructive
      questions:
      - Can I cancel a Gremlin query that's still waiting in the queue?
      - How can I stop a long-running Gremlin traversal?
      instructions:
      - text: Cancel Gremlin query {query_id}.
        slots:
          query_id: path.queryId
      - text: Kill the Gremlin traversal {query_id}.
        slots:
          query_id: path.queryId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/openCypher/status'].get
  update:
    x-apievangelist-phrasing:
      intent: List all running openCypher queries
      effect: read
      questions:
      - Which openCypher queries are running or waiting right now?
      - Can I see execution stats for active openCypher queries?
      instructions:
      - text: Show all running and waiting openCypher queries.
      - text: List active openCypher queries with their statistics.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/openCypher/status/{queryId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check one openCypher query's status
      effect: read
      questions:
      - Is a specific openCypher query still running?
      - What state is a given openCypher query in?
      instructions:
      - text: Get the status of openCypher query {query_id}.
        slots:
          query_id: path.queryId
      - text: Show stats for openCypher query {query_id}.
        slots:
          query_id: path.queryId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/openCypher/status/{queryId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Cancel an openCypher query
      effect: destructive
      questions:
      - Can I cancel an openCypher query that is hogging resources?
      - How can I stop a long-running openCypher query?
      instructions:
      - text: Cancel openCypher query {query_id}.
        slots:
          query_id: path.queryId
      - text: Kill the openCypher query {query_id}.
        slots:
          query_id: path.queryId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/sparql/status'].get
  update:
    x-apievangelist-phrasing:
      intent: List all running SPARQL queries
      effect: read
      questions:
      - Which SPARQL queries are running or waiting right now?
      - Can I see execution stats for active SPARQL queries?
      instructions:
      - text: Show all running and waiting SPARQL queries.
      - text: List active SPARQL queries with their statistics.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/sparql/status/{queryId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check one SPARQL query's status
      effect: read
      questions:
      - Is a specific SPARQL query still running?
      - What state is a given SPARQL query in?
      instructions:
      - text: Get the status of SPARQL query {query_id}.
        slots:
          query_id: path.queryId
      - text: Show stats for SPARQL query {query_id}.
        slots:
          query_id: path.queryId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/sparql/status/{queryId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Cancel a SPARQL query
      effect: destructive
      questions:
      - Can I cancel a SPARQL query that is taking too long?
      - How can I stop a runaway SPARQL query?
      instructions:
      - text: Cancel SPARQL query {query_id}.
        slots:
          query_id: path.queryId
      - text: Kill the SPARQL query {query_id}.
        slots:
          query_id: path.queryId
      method: generated
      generated: '2026-10-01'