# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Postman Collection Items API
  version: 1.0.0
extends: openapi/postman-collection-items-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: 12
- target: $.paths['/collections/{collectionId}/folders'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a folder in a collection
      effect: write
      questions:
      - What's the way to add a new folder to a collection?
      - Can I create a folder with a name in an existing collection?
      instructions:
      - text: Create a folder named {name} in collection {collectionId}.
        slots:
          name: requestBody.name
          collectionId: path.collectionId
      - text: Add folder {folder} to collection {collectionId}.
        slots:
          folder: requestBody.folder
          collectionId: path.collectionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/collections/{collectionId}/requests'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a request to a collection
      effect: write
      questions:
      - How do I add a new request to a collection or one of its folders?
      - Can I set the method, URL, headers and body when creating a request?
      instructions:
      - text: Add a {method} request to {url} named {name} in collection {collectionId}.
        slots:
          method: requestBody.method
          url: requestBody.url
          name: requestBody.name
          collectionId: path.collectionId
      - text: Create request {name} inside folder {folderId} of collection {collectionId}.
        slots:
          name: requestBody.name
          folderId: query.folderId
          collectionId: path.collectionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/collections/{collectionId}/responses'].post
  update:
    x-apievangelist-phrasing:
      intent: Save an example response on a request
      effect: write
      questions:
      - Can I save an example response for a request in a collection?
      - Which fields, like status code and body, can a new example response carry?
      instructions:
      - text: Save an example response named {name} on request {request} in collection {collectionId}.
        slots:
          name: requestBody.name
          request: query.request
          collectionId: path.collectionId
      - text: Add a {responseCode} example with body {text} to request {request} in collection {collectionId}.
        slots:
          responseCode: requestBody.responseCode
          text: requestBody.text
          request: query.request
          collectionId: path.collectionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/collections/{collectionId}/folders/{folderId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a folder in a collection
      effect: read
      questions:
      - Is there a way to look up one folder inside a collection by ID?
      - Can I get a folder with its full contents populated?
      instructions:
      - text: Get folder {folderId} in collection {collectionId}.
        slots:
          folderId: path.folderId
          collectionId: path.collectionId
      - text: Show folder {folderId} from collection {collectionId} with its contents populated.
        slots:
          folderId: path.folderId
          collectionId: path.collectionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/collections/{collectionId}/folders/{folderId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Rename or redescribe a folder
      effect: write
      questions:
      - Can I rename a folder in a collection?
      - How do I change a collection folder's description?
      instructions:
      - text: Rename folder {folderId} in collection {collectionId} to {name}.
        slots:
          folderId: path.folderId
          collectionId: path.collectionId
          name: requestBody.name
      - text: Set the description of folder {folderId} in {collectionId} to {description}.
        slots:
          folderId: path.folderId
          collectionId: path.collectionId
          description: requestBody.description
      method: generated
      generated: '2026-10-01'
- target: $.paths['/collections/{collectionId}/folders/{folderId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a folder from a collection
      effect: destructive
      questions:
      - What's the call to delete a folder from a collection?
      - Can I remove a whole folder of requests at once?
      instructions:
      - text: Delete folder {folderId} from collection {collectionId}.
        slots:
          folderId: path.folderId
          collectionId: path.collectionId
      - text: Remove the folder {folderId} and its contents from {collectionId}.
        slots:
          folderId: path.folderId
          collectionId: path.collectionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/collections/{collectionId}/requests/{requestId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a request in a collection
      effect: read
      questions:
      - Where can I read one saved request's details from a collection?
      - Can I get a single request with its full data populated?
      instructions:
      - text: Get request {requestId} in collection {collectionId}.
        slots:
          requestId: path.requestId
          collectionId: path.collectionId
      - text: Show the method, URL and body of request {requestId} in {collectionId}.
        slots:
          requestId: path.requestId
          collectionId: path.collectionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/collections/{collectionId}/requests/{requestId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a request in a collection
      effect: write
      questions:
      - Can I change a saved request's URL or method?
      - How do I update the headers or auth of a request in a collection?
      instructions:
      - text: Change the URL of request {requestId} in collection {collectionId} to {url}.
        slots:
          requestId: path.requestId
          collectionId: path.collectionId
          url: requestBody.url
      - text: Switch request {requestId} in {collectionId} to method {method}.
        slots:
          requestId: path.requestId
          collectionId: path.collectionId
          method: requestBody.method
      method: generated
      generated: '2026-10-01'
- target: $.paths['/collections/{collectionId}/requests/{requestId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a request from a collection
      effect: destructive
      questions:
      - What removes a saved request from a collection?
      - Can I remove one request without touching the rest of the collection?
      instructions:
      - text: Delete request {requestId} from collection {collectionId}.
        slots:
          requestId: path.requestId
          collectionId: path.collectionId
      - text: Remove the saved request {requestId} in {collectionId}.
        slots:
          requestId: path.requestId
          collectionId: path.collectionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/collections/{collectionId}/responses/{responseId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a saved example response
      effect: read
      questions:
      - How do I read one saved example response in a collection?
      - Can I fetch a single example response with its data populated?
      instructions:
      - text: Get response {responseId} in collection {collectionId}.
        slots:
          responseId: path.responseId
          collectionId: path.collectionId
      - text: Show the status and body of example response {responseId} in {collectionId}.
        slots:
          responseId: path.responseId
          collectionId: path.collectionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/collections/{collectionId}/responses/{responseId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a saved example response
      effect: write
      questions:
      - Can I change the body or status code of a saved example response?
      - How do I rename an example response in a collection?
      instructions:
      - text: Update example response {responseId} in collection {collectionId} with body {text}.
        slots:
          responseId: path.responseId
          collectionId: path.collectionId
          text: requestBody.text
      - text: Rename example response {responseId} in {collectionId} to {name}.
        slots:
          responseId: path.responseId
          collectionId: path.collectionId
          name: requestBody.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/collections/{collectionId}/responses/{responseId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a saved example response
      effect: destructive
      questions:
      - How do I delete an example response from a request?
      - Can I remove one saved response from a collection?
      instructions:
      - text: Delete response {responseId} from collection {collectionId}.
        slots:
          responseId: path.responseId
          collectionId: path.collectionId
      - text: Remove the example response {responseId} in {collectionId}.
        slots:
          responseId: path.responseId
          collectionId: path.collectionId
      method: generated
      generated: '2026-10-01'