# 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 Query API
  version: 1.0.0
extends: openapi/amazon-neptune-query-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['/gremlin'].get
  update:
    x-apievangelist-phrasing:
      intent: Run a Gremlin traversal via a GET URL
      effect: read
      questions:
      - Can I send a simple Gremlin traversal as a URL query parameter?
      - Is there a GET option for Gremlin when I don't want to build a JSON body?
      instructions:
      - text: Run Gremlin {gremlin} as a GET request.
        slots:
          gremlin: query.gremlin
      - text: 'Send this traversal on the URL with HTTP GET: {gremlin}.'
        slots:
          gremlin: query.gremlin
      method: generated
      generated: '2026-10-01'
- target: $.paths['/gremlin'].post
  update:
    x-apievangelist-phrasing:
      intent: Run a Gremlin traversal via HTTP POST
      effect: write
      questions:
      - How do I POST a Gremlin traversal to the Neptune HTTP REST endpoint?
      - Does the Gremlin POST endpoint return all results in one response?
      instructions:
      - text: POST the Gremlin traversal {gremlin} to the REST endpoint.
        slots:
          gremlin: requestBody.gremlin
      - text: Submit {gremlin} as a JSON body to the Gremlin HTTP endpoint.
        slots:
          gremlin: requestBody.gremlin
      method: generated
      generated: '2026-10-01'
- target: $.paths['/openCypher'].get
  update:
    x-apievangelist-phrasing:
      intent: Run an openCypher query via a GET URL
      effect: read
      questions:
      - Can I run an openCypher query by putting it in the URL?
      - Does the openCypher GET endpoint support chunked transfer encoding?
      instructions:
      - text: Run openCypher {query} as a GET request.
        slots:
          query: query.query
      - text: Send openCypher {query} on the URL with TE header {te}.
        slots:
          query: query.query
          te: header.TE
      method: generated
      generated: '2026-10-01'
- target: $.paths['/openCypher'].post
  update:
    x-apievangelist-phrasing:
      intent: Run an openCypher query via HTTP POST form
      effect: write
      questions:
      - How do I POST a form-encoded openCypher query to Neptune?
      - Can a form-posted openCypher query create or update nodes?
      instructions:
      - text: POST openCypher query {query} as a form parameter.
        slots:
          query: requestBody.query
      - text: Submit form-encoded openCypher {query} with TE header {te}.
        slots:
          query: requestBody.query
          te: header.TE
      method: generated
      generated: '2026-10-01'
- target: $.paths['/sparql'].get
  update:
    x-apievangelist-phrasing:
      intent: Run a read-only SPARQL query via GET
      effect: read
      questions:
      - Which SPARQL query forms can I send with an HTTP GET?
      - Can I run a SELECT or ASK query against my RDF data from a URL?
      instructions:
      - text: Run SPARQL {query} as a GET request.
        slots:
          query: query.query
      - text: 'Send this read-only SPARQL SELECT over GET: {query}.'
        slots:
          query: query.query
      method: generated
      generated: '2026-10-01'
- target: $.paths['/sparql'].post
  update:
    x-apievangelist-phrasing:
      intent: Run a SPARQL query or update via POST
      effect: write
      questions:
      - How do I run a SPARQL update that inserts or deletes triples?
      - Can I scope a SPARQL update to a specific graph URI?
      instructions:
      - text: POST the SPARQL update {update}.
        slots:
          update: requestBody.update
      - text: Run SPARQL update {update} using graph {graph}.
        slots:
          update: requestBody.update
          graph: requestBody.using-graph-uri
      - text: POST SPARQL query {query} to the HTTP SPARQL endpoint.
        slots:
          query: requestBody.query
      method: generated
      generated: '2026-10-01'