# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Postman Mock Servers Server Responses API
  version: 1.0.0
extends: openapi/postman-server-responses-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: 4
- target: $.paths['/mocks/{mockId}/serverResponses'].get
  update:
    x-apievangelist-phrasing:
      intent: List a mock server's custom responses
      effect: read
      questions:
      - Which custom server responses override the defaults on my mock server?
      - Can I see every server response configured for a mock?
      instructions:
      - text: List the server responses on mock {mockId}.
        slots:
          mockId: path.mockId
      - text: Show the custom overrides configured for mock server {mockId}.
        slots:
          mockId: path.mockId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/mocks/{mockId}/serverResponses'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a custom response to a mock server
      effect: write
      questions:
      - How do I make my mock server return a 500 error to test failure handling?
      - Can I set custom headers and a body on a mock server response?
      instructions:
      - text: Create a server response {name} returning status {statusCode} on mock {mockId}.
        slots:
          name: requestBody.name
          statusCode: requestBody.statusCode
          mockId: path.mockId
      - text: Add response {name} with status {statusCode} and body {body} to mock server {mockId}.
        slots:
          name: requestBody.name
          statusCode: requestBody.statusCode
          body: requestBody.body
          mockId: path.mockId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/mocks/{mockId}/serverResponses/{serverResponseId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Change a mock server's custom response
      effect: write
      questions:
      - How do I change the status code of an existing mock server response?
      - Can I edit the body of a server response I already created?
      instructions:
      - text: Update server response {serverResponseId} on mock {mockId} to {name} with status {statusCode}.
        slots:
          serverResponseId: path.serverResponseId
          mockId: path.mockId
          name: requestBody.name
          statusCode: requestBody.statusCode
      - text: Change the body of mock {mockId}'s response {serverResponseId} to {body}, keeping name {name} and status {statusCode}.
        slots:
          mockId: path.mockId
          serverResponseId: path.serverResponseId
          body: requestBody.body
          name: requestBody.name
          statusCode: requestBody.statusCode
      method: generated
      generated: '2026-09-26'
- target: $.paths['/mocks/{mockId}/serverResponses/{serverResponseId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a custom response from a mock server
      effect: destructive
      questions:
      - Can I delete a custom server response so the mock falls back to collection examples?
      - Can I remove one server response without deleting the mock?
      instructions:
      - text: Delete server response {serverResponseId} from mock {mockId}.
        slots:
          serverResponseId: path.serverResponseId
          mockId: path.mockId
      - text: Remove the custom override {serverResponseId} on mock server {mockId}.
        slots:
          serverResponseId: path.serverResponseId
          mockId: path.mockId
      method: generated
      generated: '2026-09-26'