# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for BigPanda Meetings & Transcripts API
  version: 1.0.0
extends: openapi/bigpanda-meetings-transcripts-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['/generate'].post
  update:
    x-apievangelist-phrasing:
      intent: Summarize a meeting transcript
      effect: write
      questions:
      - Can Biggy summarize a bridge call we just finished?
      - Can I steer the transcript summary with my own prompt and pick the response format?
      instructions:
      - text: Summarize the transcript for conference call {conferenceCallId}.
        slots:
          conferenceCallId: requestBody.conferenceCallId
      - text: Generate a {responseFormat} summary of meeting {meetingUrl} focused on {prompt}.
        slots:
          responseFormat: requestBody.responseFormat
          meetingUrl: requestBody.meetingUrl
          prompt: requestBody.prompt
      method: generated
      generated: '2026-09-26'
- target: $.paths['/meetings/join'].post
  update:
    x-apievangelist-phrasing:
      intent: Invite Biggy to join and transcribe a meeting
      effect: write
      questions:
      - How do I get Biggy to join our incident bridge and take notes?
      - Where does Biggy send the summary after it transcribes a meeting?
      instructions:
      - text: Invite Biggy to join {meetingUrl} and send the summary to {summaryDestination}.
        slots:
          meetingUrl: requestBody.meetingUrl
          summaryDestination: requestBody.summaryDestination
      - text: Have Biggy transcribe the call at {meetingUrl}, posting results to {summaryDestination}.
        slots:
          meetingUrl: requestBody.meetingUrl
          summaryDestination: requestBody.summaryDestination
      method: generated
      generated: '2026-09-26'
- target: $.paths['/transcripts'].get
  update:
    x-apievangelist-phrasing:
      intent: List transcribed meetings
      effect: read
      questions:
      - Which meetings and calls has Biggy transcribed for us?
      - Can I filter transcribed meetings by platform and date range?
      instructions:
      - text: List transcripts matching {search}.
        slots:
          search: query.search
      - text: Show {platform} transcripts from {from} to {to}, {limit} per page.
        slots:
          platform: query.platform
          from: query.from
          to: query.to
          limit: query.limit
      method: generated
      generated: '2026-09-26'
- target: $.paths['/transcripts/raw'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the raw transcript of a call
      effect: read
      questions:
      - Can I read the full word-for-word transcript of a call, chat included?
      - Which transcript do I get if a meeting link was used for several calls?
      instructions:
      - text: Get the raw transcript for conference call {conferenceCallId}.
        slots:
          conferenceCallId: query.conferenceCallId
      - text: Fetch the unsummarized transcript for meeting {meetingUrl}.
        slots:
          meetingUrl: requestBody.meetingUrl
      method: generated
      generated: '2026-09-26'