# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for SASE 5G Manage Service UE Info Resource API
  version: 1.0.0
extends: openapi/palo-alto-networks-ue-info-resource-api-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 7
- target: $.paths['/mt/manage/5g/tenantUEInfo'].post
  update:
    x-apievangelist-phrasing:
      intent: Map a device's IMSI and IMEI to a tenant
      effect: write
      questions:
      - How do I onboard a 5G device by tying its IMSI and IMEI to a tenant?
      - Can I associate an APN with a tenant's user equipment mapping?
      instructions:
      - text: Map IMSI {imsi} and IMEI {imei} to tenant {tsg_id}.
        slots:
          imsi: requestBody.imsi
          imei: requestBody.imei
          tsg_id: requestBody.tsg_id
      - text: Register device IMEI {imei} on APN {apn} for TSG {tsg_id}.
        slots:
          imei: requestBody.imei
          apn: requestBody.apn
          tsg_id: requestBody.tsg_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/mt/manage/5g/tenantUEInfo/delete'].post
  update:
    x-apievangelist-phrasing:
      intent: Bulk delete tenant device mappings
      effect: destructive
      questions:
      - How do I remove many tenant-to-device mappings at once when offboarding a tenant?
      - Can I batch delete UE identity records by a list of IDs?
      instructions:
      - text: Delete the tenant UE mappings {identityIds}.
        slots:
          identityIds: requestBody.identityIds
      - text: Bulk remove identity records {identityIds} for decommissioned hardware.
        slots:
          identityIds: requestBody.identityIds
      method: generated
      generated: '2026-09-26'
- target: $.paths['/mt/manage/5g/tenantUEInfo/list'].post
  update:
    x-apievangelist-phrasing:
      intent: List a tenant's device identity mappings
      effect: read
      questions:
      - Which IMSI and IMEI mappings belong to a given tenant service group?
      - Can I filter, sort and page the list of tenant UE mappings?
      instructions:
      - text: List UE identity mappings for TSG {tsg_id}.
        slots:
          tsg_id: requestBody.tsg_id
      - text: Show page {page} of tenant device mappings matching {filter}, {size} per page.
        slots:
          page: query.page
          filter: query.filter
          size: query.size
      method: generated
      generated: '2026-09-26'
- target: $.paths['/mt/manage/5g/tenantUEInfo/upload'].post
  update:
    x-apievangelist-phrasing:
      intent: Bulk upload device identity mappings
      effect: write
      questions:
      - How do I onboard thousands of 5G devices at once from a file?
      - Can I upload a mapping file for a specific TSG?
      instructions:
      - text: Upload UE mapping file {file} for TSG {tsgId}.
        slots:
          file: requestBody.file
          tsgId: requestBody.tsgId
      - text: Bulk import device identities from {filename} under root TSG {rootTsgId}.
        slots:
          filename: requestBody.filename
          rootTsgId: requestBody.rootTsgId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/mt/manage/5g/tenantUEInfo/{identity_id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a device identity mapping
      effect: write
      questions:
      - How do I fix a typo in a device's IMSI or IMEI mapping?
      - Can I change the APN on an existing tenant UE mapping?
      instructions:
      - text: Update identity {identity_id} to IMSI {imsi}.
        slots:
          identity_id: path.identity_id
          imsi: requestBody.imsi
      - text: Change the APN of mapping {identity_id} to {apn}.
        slots:
          identity_id: path.identity_id
          apn: requestBody.apn
      method: generated
      generated: '2026-09-26'
- target: $.paths['/mt/manage/5g/tenantUEInfo/{identity_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a single device identity mapping
      effect: destructive
      questions:
      - How do I delete the mapping for just one decommissioned device?
      - Can I remove one tenant UE record by its identity ID?
      instructions:
      - text: Delete identity mapping {identity_id}.
        slots:
          identity_id: path.identity_id
      - text: Remove the single UE record {identity_id} for a retired device.
        slots:
          identity_id: path.identity_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/mt/manage/5g/tenantUEInfo/{ueInfoId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one device identity record
      effect: read
      questions:
      - How do I look up the full identity record for one subscriber device?
      - Can I include unknown UEs when fetching an identity record?
      instructions:
      - text: Get UE identity record {ueInfoId}.
        slots:
          ueInfoId: path.ueInfoId
      - text: Fetch identity {ueInfoId} including unknown UEs {unknownUes}.
        slots:
          ueInfoId: path.ueInfoId
          unknownUes: query.unknownUes
      method: generated
      generated: '2026-09-26'