# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Postman Private API Network API
  version: 1.0.0
extends: openapi/postman-private-api-network-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: 6
- target: $.paths['/network/private'].get
  update:
    x-apievangelist-phrasing:
      intent: List workspaces in the Private API Network
      effect: read
      questions:
      - Which workspaces has my team published to the Private API Network?
      - Can I filter Private API Network entries by name, who added them, or date?
      instructions:
      - text: List the workspaces in our Private API Network.
      - text: Find Private API Network workspaces named {name}.
        slots:
          name: query.name
      - text: List Private API Network entries added by {addedBy} since {since}.
        slots:
          addedBy: query.addedBy
          since: query.since
      method: generated
      generated: '2026-10-01'
- target: $.paths['/network/private'].post
  update:
    x-apievangelist-phrasing:
      intent: Publish a workspace to the Private API Network
      effect: write
      questions:
      - How do I add a workspace to our team's Private API Network?
      - Can I make a workspace discoverable in the private network?
      instructions:
      - text: Add workspace {workspace} to the Private API Network.
        slots:
          workspace: requestBody.workspace
      - text: Publish workspace {workspace} in our team's private network.
        slots:
          workspace: requestBody.workspace
      method: generated
      generated: '2026-10-01'
- target: $.paths['/network/private/workspace/{workspaceId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a private network workspace (deprecated)
      effect: write
      questions:
      - Is there a deprecated endpoint for updating a workspace entry in the Private API Network?
      - Can I still edit a private network workspace entry with the old update endpoint?
      instructions:
      - text: Use the deprecated endpoint to update private network workspace {workspaceId}.
        slots:
          workspaceId: path.workspaceId
      - text: Update the Private API Network entry for {workspaceId} with {workspace} the legacy way.
        slots:
          workspaceId: path.workspaceId
          workspace: requestBody.workspace
      method: generated
      generated: '2026-10-01'
- target: $.paths['/network/private/workspace/{workspaceId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a workspace from the Private API Network
      effect: destructive
      questions:
      - Does removing a workspace from the Private API Network delete it?
      - How do I unlist a workspace from our private network?
      instructions:
      - text: Remove workspace {workspaceId} from the Private API Network.
        slots:
          workspaceId: path.workspaceId
      - text: Unlist workspace {workspaceId} from our private network without deleting it.
        slots:
          workspaceId: path.workspaceId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/network/private/network-entity/request/all'].get
  update:
    x-apievangelist-phrasing:
      intent: List requests to add workspaces to the network
      effect: read
      questions:
      - Who has asked to add workspaces to our Private API Network?
      - Can I see only pending or denied add requests?
      instructions:
      - text: List all requests to add workspaces to our Private API Network.
      - text: Show {status} Private API Network add requests.
        slots:
          status: query.status
      - text: List add requests made by {requestedBy}.
        slots:
          requestedBy: query.requestedBy
      method: generated
      generated: '2026-10-01'
- target: $.paths['/network/private/network-entity/request/{requestId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Approve or deny a request to add a workspace
      effect: write
      questions:
      - Who can approve a request to add a workspace to the Private API Network?
      - Can I leave a message when denying a private network add request?
      instructions:
      - text: Set add request {requestId} to {status}.
        slots:
          requestId: path.requestId
          status: requestBody.status
      - text: Deny workspace add request {requestId} with status {status} and message {response}.
        slots:
          requestId: path.requestId
          status: requestBody.status
          response: requestBody.response
      method: generated
      generated: '2026-10-01'