# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for CRM Pipelines API
  version: 1.0.0
extends: openapi/vendasta-pipelines-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: 5
- target: $.paths['/v1/crm/pipeline/create'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a sales pipeline
      effect: write
      questions:
      - How do I set up a new sales pipeline in the CRM?
      - What does a pipeline definition include when I create one?
      instructions:
      - text: Create pipeline {pipeline}.
        slots:
          pipeline: requestBody.pipeline
      - text: Set up a new CRM sales pipeline with stages {pipeline}.
        slots:
          pipeline: requestBody.pipeline
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/crm/pipeline/delete'].post
  update:
    x-apievangelist-phrasing:
      intent: Delete a sales pipeline
      effect: destructive
      questions:
      - Can I remove a pipeline I no longer use?
      - What's required to delete a CRM pipeline?
      instructions:
      - text: Delete pipeline {pipeline} in namespace {namespace}.
        slots:
          pipeline: requestBody.pipelineId
          namespace: requestBody.namespace
      - text: Remove sales pipeline {pipeline} from {namespace}.
        slots:
          pipeline: requestBody.pipelineId
          namespace: requestBody.namespace
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/crm/pipeline/get-multi'].post
  update:
    x-apievangelist-phrasing:
      intent: Get several pipelines by ID
      effect: read
      questions:
      - Can I fetch a couple of pipelines at once when I know their IDs?
      - What stages does a specific pipeline have?
      instructions:
      - text: Get pipelines {ids} in namespace {namespace}.
        slots:
          ids: requestBody.pipelineIds
          namespace: requestBody.namespace
      - text: Show the stages of pipelines {ids} in {namespace}.
        slots:
          ids: requestBody.pipelineIds
          namespace: requestBody.namespace
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/crm/pipeline/list'].post
  update:
    x-apievangelist-phrasing:
      intent: List CRM pipelines
      effect: read
      questions:
      - Which sales pipelines exist in my CRM?
      - Can I page through all pipelines?
      instructions:
      - text: List pipelines using options {options}.
        slots:
          options: requestBody.listOptions
      - text: Show all my CRM pipelines with {options}.
        slots:
          options: requestBody.listOptions
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/crm/pipeline/update'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a sales pipeline
      effect: write
      questions:
      - Can I rename a pipeline or change its stages?
      - Is there a way to update just certain pipeline fields?
      instructions:
      - text: Update pipeline {pipeline}.
        slots:
          pipeline: requestBody.pipeline
      - text: Change only {mask} on pipeline {pipeline}.
        slots:
          mask: requestBody.fieldMask
          pipeline: requestBody.pipeline
      method: generated
      generated: '2026-10-01'