# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Leadping Calls API
  version: 1.0.0
extends: openapi/leadping-calls-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['/phone-call/initiate'].post
  update:
    x-apievangelist-phrasing:
      intent: Place a phone call to a lead
      effect: write
      questions:
      - How do I start an outbound phone call to a lead?
      - Can I choose which of my numbers the call comes from?
      instructions:
      - text: Call lead {leadId}.
        slots:
          leadId: requestBody.leadId
      - text: Call lead {leadId} from phone number {fromPhoneNumberId}.
        slots:
          leadId: requestBody.leadId
          fromPhoneNumberId: requestBody.fromPhoneNumberId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/phone-call/{callId}/hangup'].post
  update:
    x-apievangelist-phrasing:
      intent: Hang up an active call
      effect: destructive
      questions:
      - How do I end a call that's still in progress?
      - Can an agent hang up a live Leadping call for me?
      instructions:
      - text: Hang up call {callId}.
        slots:
          callId: path.callId
      - text: End active call {callId} now.
        slots:
          callId: path.callId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/phone-call/{callId}/status'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a phone call's status
      effect: read
      questions:
      - Is my call still ringing, connected, or finished?
      - How can I check the current state of a phone call?
      instructions:
      - text: Get the status of call {callId}.
        slots:
          callId: path.callId
      - text: Check whether call {callId} is still active.
        slots:
          callId: path.callId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/phone-call/{callId}/transfer'].post
  update:
    x-apievangelist-phrasing:
      intent: Transfer an active call
      effect: write
      questions:
      - How do I transfer a live call to another phone number?
      - Can I hand off a call in progress to a colleague's number?
      instructions:
      - text: Transfer call {callId} to {newPhoneNumber}.
        slots:
          callId: path.callId
          newPhoneNumber: query.newPhoneNumber
      - text: Forward active call {callId} to another number.
        slots:
          callId: path.callId
      method: generated
      generated: '2026-09-26'