# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: 'API Evangelist conversational phrasing for Prisma Cloud: Managed Security Service Provider (MSSP) User…'
  version: 1.0.0
extends: openapi/palo-alto-networks-user-management-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: 8
- target: $.paths['/api/v1/user/{username}/credential'].put
  update:
    x-apievangelist-phrasing:
      intent: Change a user's password
      effect: write
      questions:
      - How do I set a new password for a user account?
      - Can an admin change another user's password by username?
      instructions:
      - text: Change the password for {username} to {password}.
        slots:
          username: path.username
          password: requestBody.password
      - text: Set a new password {password} on user {username}.
        slots:
          password: requestBody.password
          username: path.username
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/mssp/{mssp-id}/user/{username}'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up an MSSP console user
      effect: read
      questions:
      - What are the first and last names on a user in my MSSP console?
      - Can I fetch a single MSSP user by username?
      instructions:
      - text: Get user {username} in MSSP {msspId}.
        slots:
          username: path.username
          msspId: path.mssp-id
      - text: Show the profile of {username} under MSSP account {msspId}.
        slots:
          username: path.username
          msspId: path.mssp-id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/mssp/{mssp-id}/user/{username}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an MSSP console user
      effect: write
      questions:
      - Can I correct a user's first or last name in the MSSP console?
      - How do I edit an existing MSSP user?
      instructions:
      - text: Update user {username} in MSSP {msspId} to first name {firstName} and last name {lastName}.
        slots:
          username: path.username
          msspId: path.mssp-id
          firstName: requestBody.firstName
          lastName: requestBody.lastName
      - text: Change the last name of {username} in MSSP {msspId} to {lastName}.
        slots:
          username: path.username
          msspId: path.mssp-id
          lastName: requestBody.lastName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/mssp/{mssp-id}/user/{username}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an MSSP console user
      effect: destructive
      questions:
      - How do I remove a user from an MSSP account?
      - Does deleting an MSSP user revoke their console access?
      instructions:
      - text: Delete user {username} from MSSP {msspId}.
        slots:
          username: path.username
          msspId: path.mssp-id
      - text: Remove {username}'s account under MSSP {msspId}.
        slots:
          username: path.username
          msspId: path.mssp-id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/user/{username}/credential/reset-token/validate'].post
  update:
    x-apievangelist-phrasing:
      intent: Validate a forgot-password reset token
      effect: write
      questions:
      - What happens after a user submits the password reset token from their email?
      - Can I check a reset token is valid before letting someone set a new password?
      instructions:
      - text: Validate reset token {resetToken} for user {username}.
        slots:
          resetToken: requestBody.resetToken
          username: path.username
      - text: Exchange {username}'s forgot-password token {resetToken} for a reset JWT.
        slots:
          username: path.username
          resetToken: requestBody.resetToken
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/mssp/{mssp-id}/user'].get
  update:
    x-apievangelist-phrasing:
      intent: List users of an MSSP console
      effect: read
      questions:
      - Who has user access to my managed security service provider console?
      - Can I page through the users of one MSSP tenant?
      instructions:
      - text: List the users of MSSP console {mssp-id}.
        slots:
          mssp-id: path.mssp-id
      - text: Get the next page of users for MSSP console {mssp-id} using token {next_page_token}.
        slots:
          mssp-id: path.mssp-id
          next_page_token: query.next_page_token
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/mssp/{mssp-id}/user'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a user to an MSSP account
      effect: write
      questions:
      - How do I give a new person access to an MSSP account?
      - What details are needed to create an MSSP console user?
      instructions:
      - text: Create user {username} named {firstName} {lastName} in MSSP {msspId}.
        slots:
          username: requestBody.username
          firstName: requestBody.firstName
          lastName: requestBody.lastName
          msspId: path.mssp-id
      - text: Add {username} as a new user under MSSP account {msspId}.
        slots:
          username: requestBody.username
          msspId: path.mssp-id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/user/{username}/credential/reset-token'].get
  update:
    x-apievangelist-phrasing:
      intent: Email a user a password reset token
      effect: write
      questions:
      - How does a user who forgot their password get a reset email?
      - Can I trigger the forgot-password flow for a specific username?
      instructions:
      - text: Send a password reset token to {username}.
        slots:
          username: path.username
      - text: Start the forgot-password flow for user {username}.
        slots:
          username: path.username
      method: generated
      generated: '2026-09-26'