# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Campaigns Users API
  version: 1.0.0
extends: openapi/mediamath-users-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['/users'].get
  update:
    x-apievangelist-phrasing:
      intent: List users
      effect: read
      questions:
      - Who are the users in my MediaMath account?
      - Can I search users by name or email?
      instructions:
      - text: List all users.
      - text: Search users matching {query}.
        slots:
          query: query.q
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a user
      effect: write
      questions:
      - How do I add a new user?
      - Can I invite a teammate as a user through the API?
      instructions:
      - text: Create a new user.
      - text: Add a new teammate as a user.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a user
      effect: read
      questions:
      - What details are stored for a specific user?
      - Can I look up one user by their ID?
      instructions:
      - text: Get user {user}.
        slots:
          user: path.user_id
      - text: Show the details of user {user}.
        slots:
          user: path.user_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user_id}'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a user
      effect: write
      questions:
      - How do I edit an existing user's profile?
      - Can I change a user's details by ID?
      instructions:
      - text: Update user {user}.
        slots:
          user: path.user_id
      - text: Edit the profile of user {user}.
        slots:
          user: path.user_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user_id}/history'].get
  update:
    x-apievangelist-phrasing:
      intent: View a user's change history
      effect: read
      questions:
      - Who changed this user's record and when?
      - Where is the audit trail for one user?
      instructions:
      - text: Show the audit log for user {user}.
        slots:
          user: path.user_id
      - text: List the changes made to user {user}.
        slots:
          user: path.user_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user_id}/settings'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a user's settings
      effect: read
      questions:
      - What settings are configured for a given user?
      - Can I see one user's preferences?
      instructions:
      - text: Show the settings for user {user}.
        slots:
          user: path.user_id
      - text: List the preferences configured for user {user}.
        slots:
          user: path.user_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user_id}/settings'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a user's settings
      effect: write
      questions:
      - How do I change a user's settings?
      - Can I update a user's preferences via the API?
      instructions:
      - text: Update user {user}'s settings to {settings}.
        slots:
          user: path.user_id
          settings: requestBody.settings
      - text: Change user {user}'s preferences to {settings}.
        slots:
          user: path.user_id
          settings: requestBody.settings
      method: generated
      generated: '2026-10-01'