# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Microsoft Azure Api Management User API
  version: 1.0.0
extends: openapi/microsoft-azure-api-management-user-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: 7
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/users'].get
  update:
    x-apievangelist-phrasing:
      intent: List registered users
      effect: read
      questions:
      - Which developers are registered on my API Management service?
      - Can I pull the full list of users signed up to my service instance?
      instructions:
      - text: List all registered users on my {serviceName} API Management service.
        slots:
          serviceName: path.serviceName
      - text: Show me every developer account on the service.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/users/{userId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a user's details
      effect: read
      questions:
      - How do I look up one registered developer's account details?
      - What email, name and state does a specific user have?
      instructions:
      - text: Get the account details of user {userId} in {serviceName}.
        slots:
          userId: path.userId
          serviceName: path.serviceName
      - text: Look up this developer's account on the service.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/users/{userId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace a user
      effect: write
      questions:
      - How do I register a new developer account on my service?
      - Can I create a user with a specific ID, or overwrite an existing one?
      instructions:
      - text: Create or fully replace developer user {userId} on my {serviceName} service.
        slots:
          userId: path.userId
          serviceName: path.serviceName
      - text: Create or fully replace this user account.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/users/{userId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a user
      effect: destructive
      questions:
      - How can I remove a developer account from API Management?
      - Is deleting a registered user permanent?
      instructions:
      - text: Delete user {userId} from service {serviceName} permanently.
        slots:
          userId: path.userId
          serviceName: path.serviceName
      - text: Remove this developer account permanently.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/users/{userId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a user's details
      effect: write
      questions:
      - Can I change a user's name or email without recreating the account?
      - Is it possible to block a developer by updating their account state?
      instructions:
      - text: Patch user {userId} in {serviceName} with new profile details.
        slots:
          userId: path.userId
          serviceName: path.serviceName
      - text: Block this developer by updating their account state.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/users/{userId}'].head
  update:
    x-apievangelist-phrasing:
      intent: Get a user's ETag version
      effect: read
      questions:
      - Can I read a user's ETag before updating their account?
      - Does a user with a given ID exist on my service?
      instructions:
      - text: Check the ETag of user {userId} on service {serviceName}.
        slots:
          userId: path.userId
          serviceName: path.serviceName
      - text: Confirm this user account exists from its entity state header.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/profile'].get
  update:
    x-apievangelist-phrasing:
      intent: Open my developer portal profile
      effect: read
      questions:
      - Where in the developer portal do I manage my own subscriptions and API keys?
      - Can I see my profile page with my keys in the Azure API Management developer portal?
      instructions:
      - text: Open my developer portal profile page.
      - text: Show me my portal profile with my subscriptions and API keys.
      method: generated
      generated: '2026-09-26'