API Evangelist conversational phrasing for Postman Mocks API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Postman Mocks API
  version: 1.0.0
extends: openapi/postman-mocks-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: 13
- target: $.paths['/mocks'].get
  update:
    x-apievangelist-phrasing:
      intent: List mock servers
      effect: read
      questions:
      - Which mock servers are currently active?
      - Can I list only the mock servers in one workspace or team?
      instructions:
      - text: List my active mock servers.
      - text: List the mock servers in workspace {workspace}.
        slots:
          workspace: query.workspace
      - text: Show the mock servers belonging to team {teamId}.
        slots:
          teamId: query.teamId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/mocks'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a mock server for a collection
      effect: write
      questions:
      - How do I spin up a mock server from a collection?
      - Can I create a mock for a collection that's attached to an API definition?
      instructions:
      - text: Create a mock server in workspace {workspace}.
        slots:
          workspace: query.workspace
      - text: Create mock server {mock} in workspace {workspace}.
        slots:
          mock: requestBody.mock
          workspace: query.workspace
      method: generated
      generated: '2026-09-26'
- target: $.paths['/mocks/{mockId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a mock server
      effect: read
      questions:
      - What's the URL and configuration of a particular mock server?
      - Can I look up which collection a mock server is based on?
      instructions:
      - text: Get mock server {mockId}.
        slots:
          mockId: path.mockId
      - text: Show the settings of mock {mockId}.
        slots:
          mockId: path.mockId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/mocks/{mockId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a mock server
      effect: write
      questions:
      - Can I rename a mock server or point it at a different collection?
      - How do I change a mock server's settings?
      instructions:
      - text: Update mock server {mockId} with {mock}.
        slots:
          mockId: path.mockId
          mock: requestBody.mock
      - text: Rename mock server {mockId}.
        slots:
          mockId: path.mockId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/mocks/{mockId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a mock server
      effect: destructive
      questions:
      - How do I get rid of a mock server I don't use anymore?
      - Can I delete a mock server through the API?
      instructions:
      - text: Delete mock server {mockId}.
        slots:
          mockId: path.mockId
      - text: Remove the mock {mockId} permanently.
        slots:
          mockId: path.mockId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/mocks/{mockId}/call-logs'].get
  update:
    x-apievangelist-phrasing:
      intent: Read a mock server's call logs
      effect: read
      questions:
      - What requests has my mock server received and what did it return?
      - Can I filter mock call logs by status code, method or path?
      - How many call logs come back in one call?
      instructions:
      - text: Show the call logs for mock server {mockId}.
        slots:
          mockId: path.mockId
      - text: Show mock {mockId} calls that returned status {responseStatusCode}.
        slots:
          mockId: path.mockId
          responseStatusCode: query.responseStatusCode
      - text: List {requestMethod} calls to path {requestPath} on mock {mockId}.
        slots:
          requestMethod: query.requestMethod
          requestPath: query.requestPath
          mockId: path.mockId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/mocks/{mockId}/publish'].post
  update:
    x-apievangelist-phrasing:
      intent: Make a mock server public
      effect: write
      questions:
      - How do I make a mock server publicly accessible?
      - What does publishing a mock server change in its access control?
      instructions:
      - text: Publish mock server {mockId}.
        slots:
          mockId: path.mockId
      - text: Set the access control of mock {mockId} to public.
        slots:
          mockId: path.mockId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/mocks/{mockId}/unpublish'].delete
  update:
    x-apievangelist-phrasing:
      intent: Make a mock server private
      effect: destructive
      questions:
      - Can I make a public mock server private again?
      - How do I stop a mock server from being publicly reachable?
      instructions:
      - text: Unpublish mock server {mockId}.
        slots:
          mockId: path.mockId
      - text: Switch mock {mockId} access control back to private.
        slots:
          mockId: path.mockId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/mocks/{mockId}/server-responses'].get
  update:
    x-apievangelist-phrasing:
      intent: List a mock server's simulated server errors
      effect: read
      questions:
      - What simulated 5xx server responses are set up on this mock?
      - Can I list every server response configured for a mock server?
      instructions:
      - text: List the server responses on mock {mockId}.
        slots:
          mockId: path.mockId
      - text: Show all simulated server errors configured for mock {mockId}.
        slots:
          mockId: path.mockId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/mocks/{mockId}/server-responses'].post
  update:
    x-apievangelist-phrasing:
      intent: Simulate a 5xx error on a mock server
      effect: write
      questions:
      - Can a mock server simulate a 500 or 503 outage?
      - How do I test how my app handles server-level errors with a mock?
      instructions:
      - text: Add a server response {serverResponse} to mock {mockId}.
        slots:
          serverResponse: requestBody.serverResponse
          mockId: path.mockId
      - text: Make mock {mockId} simulate a 503 server error.
        slots:
          mockId: path.mockId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/mocks/{mockId}/server-responses/{serverResponseId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one simulated server response
      effect: read
      questions:
      - How do I see the details of one simulated server response on a mock?
      - Which status code does a given mock server response return?
      instructions:
      - text: Get server response {serverResponseId} on mock {mockId}.
        slots:
          serverResponseId: path.serverResponseId
          mockId: path.mockId
      - text: Show the status code of server response {serverResponseId} in mock {mockId}.
        slots:
          serverResponseId: path.serverResponseId
          mockId: path.mockId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/mocks/{mockId}/server-responses/{serverResponseId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Change a simulated server response
      effect: write
      questions:
      - Can I change the status code of an existing simulated server error?
      - How do I edit a server response already set on a mock?
      instructions:
      - text: Update server response {serverResponseId} on mock {mockId} with {serverResponse}.
        slots:
          serverResponseId: path.serverResponseId
          mockId: path.mockId
          serverResponse: requestBody.serverResponse
      - text: Change mock {mockId}'s server response {serverResponseId} to return a 500.
        slots:
          mockId: path.mockId
          serverResponseId: path.serverResponseId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/mocks/{mockId}/server-responses/{serverResponseId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a simulated server response
      effect: destructive
      questions:
      - How do I stop a mock from returning a simulated server error?
      - Can I delete one server response from a mock server?
      instructions:
      - text: Delete server response {serverResponseId} from mock {mockId}.
        slots:
          serverResponseId: path.serverResponseId
          mockId: path.mockId
      - text: Remove the simulated error {serverResponseId} on mock {mockId}.
        slots:
          serverResponseId: path.serverResponseId
          mockId: path.mockId
      method: generated
      generated: '2026-09-26'