# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Appwrite GraphQL API
  version: 1.0.0
extends: openapi/appwrite-graph-ql-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: 2
- target: $.paths['/graphql'].post
  update:
    x-apievangelist-phrasing:
      intent: Run a GraphQL query
      effect: read
      questions:
      - Can I read my Appwrite data with a GraphQL query instead of REST calls?
      - Which endpoint do I send a GraphQL query document to?
      instructions:
      - text: 'Run this GraphQL query: {query}.'
        slots:
          query: requestBody.query
      - text: Send the GraphQL query {query} to the main GraphQL endpoint and return the data.
        slots:
          query: requestBody.query
      method: generated
      generated: '2026-10-01'
- target: $.paths['/graphql/mutation'].post
  update:
    x-apievangelist-phrasing:
      intent: Run a GraphQL mutation
      effect: write
      questions:
      - How do I change data through a GraphQL mutation?
      - Is there a dedicated endpoint just for GraphQL mutations?
      instructions:
      - text: Execute the GraphQL mutation {query}.
        slots:
          query: requestBody.query
      - text: Post {query} to the GraphQL mutation endpoint.
        slots:
          query: requestBody.query
      method: generated
      generated: '2026-10-01'