# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for LLM-ready Transcript API
  version: 1.0.0
extends: openapi/sp-global-transcript-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: 2
- target: $.paths['/api/v1/transcript/{key_dev_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a structured earnings call transcript
      effect: read
      questions:
      - Can I get an earnings call transcript broken out by speaker and section?
      - Who said what on a company's earnings call?
      instructions:
      - text: Get the transcript for key dev {key_dev_id}.
        slots:
          key_dev_id: path.key_dev_id
      - text: Show the speaker-by-speaker components of call {key_dev_id}.
        slots:
          key_dev_id: path.key_dev_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/transcript/{key_dev_id}/raw'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an earnings call transcript as plain text
      effect: read
      questions:
      - Can I get an earnings call transcript as one block of text?
      - Is there a raw-text version of a transcript with speakers marked inline?
      instructions:
      - text: Get the raw transcript text for key dev {key_dev_id}.
        slots:
          key_dev_id: path.key_dev_id
      - text: Download call {key_dev_id} as a single plain-text transcript.
        slots:
          key_dev_id: path.key_dev_id
      method: generated
      generated: '2026-10-01'