# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for App Store Connect Users API
  version: 1.0.0
extends: openapi/ios-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: 9
- target: $.paths['/v1/users'].get
  update:
    x-apievangelist-phrasing:
      intent: List team users
      effect: read
      questions:
      - Who are the users on my App Store Connect team?
      - Can I filter team members by role or username?
      - Which users can see a particular app?
      instructions:
      - text: List all users on my team.
      - text: Find users with role {role}.
        slots:
          role: query.filter[roles]
      - text: Find the user with username {username}.
        slots:
          username: query.filter[username]
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/users/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a team user
      effect: read
      questions:
      - What roles and details does a specific team user have?
      - How do I look up one App Store Connect user by ID?
      instructions:
      - text: Show user {user_id}.
        slots:
          user_id: path.id
      - text: Fetch the profile and roles of team member {user_id}.
        slots:
          user_id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/users/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a user from the team
      effect: destructive
      questions:
      - How do I remove someone from my App Store Connect team?
      - Can I revoke a user's team access entirely?
      instructions:
      - text: Remove user {user_id} from the team.
        slots:
          user_id: path.id
      - text: Delete team member {user_id}.
        slots:
          user_id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/users/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a team user
      effect: write
      questions:
      - How do I change a team member's roles?
      - Can I update a user's settings, such as whether they see all apps?
      instructions:
      - text: Update user {user_id} with {changes}.
        slots:
          user_id: path.id
          changes: requestBody.data
      - text: Change the roles of team member {user_id}.
        slots:
          user_id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/users/{id}/relationships/visibleApps'].get
  update:
    x-apievangelist-phrasing:
      intent: List app IDs a user can see
      effect: read
      questions:
      - How do I get just the IDs of apps a user has access to?
      - Which app identifiers are visible to a team member?
      instructions:
      - text: List the visible app IDs for user {user_id}.
        slots:
          user_id: path.id
      - text: Get only the visible-app linkages of user {user_id}.
        slots:
          user_id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/users/{id}/relationships/visibleApps'].post
  update:
    x-apievangelist-phrasing:
      intent: Grant a user access to apps
      effect: write
      questions:
      - How do I give a team member access to more apps?
      - Can I add apps to a user's visible list without removing existing ones?
      instructions:
      - text: Give user {user_id} access to apps {apps}.
        slots:
          user_id: path.id
          apps: requestBody.data
      - text: Add visible apps for team member {user_id}.
        slots:
          user_id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/users/{id}/relationships/visibleApps'].delete
  update:
    x-apievangelist-phrasing:
      intent: Revoke a user's access to apps
      effect: destructive
      questions:
      - How do I stop a team member from seeing certain apps?
      - Can I remove specific apps from a user's access list?
      instructions:
      - text: Revoke user {user_id}'s access to apps {apps}.
        slots:
          user_id: path.id
          apps: requestBody.data
      - text: Remove visible apps from team member {user_id}.
        slots:
          user_id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/users/{id}/relationships/visibleApps'].patch
  update:
    x-apievangelist-phrasing:
      intent: Replace the apps a user can see
      effect: write
      questions:
      - How do I set exactly which apps a user can access?
      - Can I overwrite a team member's full visible-app list at once?
      instructions:
      - text: Replace user {user_id}'s visible apps with {apps}.
        slots:
          user_id: path.id
          apps: requestBody.data
      - text: Reset the complete app access list for user {user_id}.
        slots:
          user_id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/users/{id}/visibleApps'].get
  update:
    x-apievangelist-phrasing:
      intent: List apps a user can see
      effect: read
      questions:
      - Which apps can a given team member see, with full details?
      - What apps show up for a specific user in App Store Connect?
      instructions:
      - text: Show the apps visible to user {user_id}.
        slots:
          user_id: path.id
      - text: List full app records team member {user_id} can access.
        slots:
          user_id: path.id
      method: generated
      generated: '2026-10-01'