# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Twilio - Supersim Network Access Profiles API
  version: 1.0.0
extends: openapi/twilio-networkaccessprofiles-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: 8
- target: $.paths['/v1/NetworkAccessProfiles'].get
  update:
    x-apievangelist-phrasing:
      intent: List network access profiles
      effect: read
      questions:
      - Which network access profiles have I set up for my SIMs?
      - Can I see all the profiles that control which cellular networks my devices use?
      instructions:
      - text: List my network access profiles.
      - text: Show my network access profiles, {page_size} per page.
        slots:
          page_size: query.PageSize
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/NetworkAccessProfiles'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a network access profile
      effect: write
      questions:
      - How do I restrict my SIMs to a chosen set of cellular networks?
      - Can I list the allowed networks when creating a new access profile?
      instructions:
      - text: Create a network access profile named {unique_name}.
        slots:
          unique_name: requestBody.UniqueName
      - text: Create a network access profile {unique_name} allowing networks {networks}.
        slots:
          unique_name: requestBody.UniqueName
          networks: requestBody.Networks
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/NetworkAccessProfiles/{Sid}'].get
  update:
    x-apievangelist-phrasing:
      intent: View a network access profile
      effect: read
      questions:
      - What does a particular network access profile look like?
      - Can I fetch one access profile by its SID?
      instructions:
      - text: Fetch network access profile {profile_sid}.
        slots:
          profile_sid: path.Sid
      - text: Show the details of access profile {profile_sid}.
        slots:
          profile_sid: path.Sid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/NetworkAccessProfiles/{Sid}'].post
  update:
    x-apievangelist-phrasing:
      intent: Rename a network access profile
      effect: write
      questions:
      - Can I change the unique name of an existing network access profile?
      - Which properties of an access profile can be updated after creation?
      instructions:
      - text: Rename network access profile {profile_sid} to {unique_name}.
        slots:
          profile_sid: path.Sid
          unique_name: requestBody.UniqueName
      - text: Give existing access profile {profile_sid} the new unique name {unique_name}.
        slots:
          profile_sid: path.Sid
          unique_name: requestBody.UniqueName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/NetworkAccessProfiles/{NetworkAccessProfileSid}/Networks'].get
  update:
    x-apievangelist-phrasing:
      intent: List networks allowed by an access profile
      effect: read
      questions:
      - Which cellular networks does a given access profile allow?
      - Where can I see every network attached to one network access profile?
      instructions:
      - text: List the networks in access profile {profile_sid}.
        slots:
          profile_sid: path.NetworkAccessProfileSid
      - text: Show which carriers profile {profile_sid} lets SIMs connect to.
        slots:
          profile_sid: path.NetworkAccessProfileSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/NetworkAccessProfiles/{NetworkAccessProfileSid}/Networks'].post
  update:
    x-apievangelist-phrasing:
      intent: Allow a network in an access profile
      effect: write
      questions:
      - Can I add one more carrier network to an existing access profile?
      - How do I let SIMs on a profile connect to an additional network?
      instructions:
      - text: Add network {network_sid} to access profile {profile_sid}.
        slots:
          network_sid: requestBody.Network
          profile_sid: path.NetworkAccessProfileSid
      - text: Allow SIMs on profile {profile_sid} to use network {network_sid}.
        slots:
          profile_sid: path.NetworkAccessProfileSid
          network_sid: requestBody.Network
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/NetworkAccessProfiles/{NetworkAccessProfileSid}/Networks/{Sid}'].get
  update:
    x-apievangelist-phrasing:
      intent: View a network within an access profile
      effect: read
      questions:
      - Is a specific network part of my access profile, and what are its details?
      - Can I fetch a single network entry from a network access profile?
      instructions:
      - text: Fetch network {network_sid} from access profile {profile_sid}.
        slots:
          network_sid: path.Sid
          profile_sid: path.NetworkAccessProfileSid
      - text: Show the country and identifiers of network {network_sid} in profile {profile_sid}.
        slots:
          network_sid: path.Sid
          profile_sid: path.NetworkAccessProfileSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/NetworkAccessProfiles/{NetworkAccessProfileSid}/Networks/{Sid}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a network from an access profile
      effect: destructive
      questions:
      - Can I block my SIMs from a carrier by taking it off their access profile?
      - What removes a network from a network access profile?
      instructions:
      - text: Remove network {network_sid} from access profile {profile_sid}.
        slots:
          network_sid: path.Sid
          profile_sid: path.NetworkAccessProfileSid
      - text: Stop SIMs on profile {profile_sid} from using network {network_sid}.
        slots:
          profile_sid: path.NetworkAccessProfileSid
          network_sid: path.Sid
      method: generated
      generated: '2026-09-26'