# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Postman APIs API Comments Network Elements API
  version: 1.0.0
extends: openapi/postman-network-elements-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: 3
- target: $.paths['/network/private'].post
  update:
    x-apievangelist-phrasing:
      intent: Publish an element to the private API network
      effect: write
      questions:
      - How do I publish an API or collection to our private API network?
      - Can I put a network element into a specific folder with a summary?
      instructions:
      - text: Publish {type} {id} to the private API network.
        slots:
          type: requestBody.type
          id: requestBody.id
      - text: Add {type} {id} to network folder {parentFolderId} with summary {summary}.
        slots:
          type: requestBody.type
          id: requestBody.id
          parentFolderId: requestBody.parentFolderId
          summary: requestBody.summary
      method: generated
      generated: '2026-09-26'
- target: $.paths['/network/private/{elementType}/{elementId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an element's private network listing
      effect: write
      questions:
      - Can I change the summary of an element listed in the private network?
      - How do I move a private network element into another folder?
      instructions:
      - text: Update the summary of {elementType} {elementId} in the private network to {summary}.
        slots:
          elementType: path.elementType
          elementId: path.elementId
          summary: requestBody.summary
      - text: Move network element {elementId} ({elementType}) into folder {parentFolderId}.
        slots:
          elementId: path.elementId
          elementType: path.elementType
          parentFolderId: requestBody.parentFolderId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/network/private/{elementType}/{elementId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove an element from the private API network
      effect: destructive
      questions:
      - Does removing an element from the private network delete the underlying collection or API?
      - What's the way to unlist an element from our internal API catalog?
      instructions:
      - text: Remove {elementType} {elementId} from the private API network.
        slots:
          elementType: path.elementType
          elementId: path.elementId
      - text: Unlist element {elementId} of type {elementType} from the network catalog.
        slots:
          elementId: path.elementId
          elementType: path.elementType
      method: generated
      generated: '2026-09-26'