API Evangelist conversational phrasing for Azure API Management REST Graph QL API Resolver API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Azure API Management REST Graph QL API Resolver API
  version: 1.0.0
extends: openapi/microsoft-azure-api-management-graphqlapiresolver-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['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/resolvers'].get
  update:
    x-apievangelist-phrasing:
      intent: List resolvers of a GraphQL API
      effect: read
      questions:
      - Which resolvers are defined on my GraphQL API in API Management?
      - Can I see every field resolver for a synthetic GraphQL API?
      instructions:
      - text: List all resolvers on GraphQL API {apiId} in my {serviceName} service.
        slots:
          apiId: path.apiId
          serviceName: path.serviceName
      - text: Show me every resolver for this GraphQL API.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/resolvers/{resolverId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a GraphQL resolver
      effect: read
      questions:
      - How do I see how one GraphQL resolver is configured?
      - What type and field does a particular resolver handle?
      instructions:
      - text: Get the configuration of resolver {resolverId} on GraphQL API {apiId} in {serviceName}.
        slots:
          resolverId: path.resolverId
          apiId: path.apiId
          serviceName: path.serviceName
      - text: Show me one GraphQL resolver's configuration.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/resolvers/{resolverId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace a GraphQL resolver
      effect: write
      questions:
      - How do I add a resolver to a GraphQL API?
      - Can I overwrite an existing GraphQL resolver in one call?
      instructions:
      - text: Create or replace resolver {resolverId} on GraphQL API {apiId} in service {serviceName}.
        slots:
          resolverId: path.resolverId
          apiId: path.apiId
          serviceName: path.serviceName
      - text: Create or fully replace this GraphQL resolver.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/resolvers/{resolverId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a GraphQL resolver
      effect: destructive
      questions:
      - How can I remove a resolver from my GraphQL API?
      - Is deleting a GraphQL resolver permanent?
      instructions:
      - text: Delete resolver {resolverId} from GraphQL API {apiId} in {serviceName}.
        slots:
          resolverId: path.resolverId
          apiId: path.apiId
          serviceName: path.serviceName
      - text: Remove this resolver from the GraphQL API.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/resolvers/{resolverId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a GraphQL resolver
      effect: write
      questions:
      - Can I change a few details on an existing GraphQL resolver without recreating it?
      - Is there a way to patch a resolver's description or path?
      instructions:
      - text: Patch the existing resolver {resolverId} on GraphQL API {apiId} in {serviceName}.
        slots:
          resolverId: path.resolverId
          apiId: path.apiId
          serviceName: path.serviceName
      - text: Update the description of a GraphQL resolver that already exists.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/resolvers/{resolverId}'].head
  update:
    x-apievangelist-phrasing:
      intent: Get a GraphQL resolver's ETag
      effect: read
      questions:
      - Can I read a GraphQL resolver's ETag before editing it?
      - Does a resolver with a given ID exist on my GraphQL API?
      instructions:
      - text: Check the ETag of resolver {resolverId} on GraphQL API {apiId} in service {serviceName}.
        slots:
          resolverId: path.resolverId
          apiId: path.apiId
          serviceName: path.serviceName
      - text: Confirm this GraphQL resolver exists from its entity state header.
      method: generated
      generated: '2026-10-01'