# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Transcriptfetch System API
  version: 1.0.0
extends: openapi/transcriptfetch-system-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: 4
- target: $.paths['/api/v1/me'].get
  update:
    x-apievangelist-phrasing:
      intent: Check API key and credit balance (v1)
      effect: read
      questions:
      - Is my API key valid on the older v1 Transcriptfetch endpoint?
      - Can I check my remaining credits through the v1 API without being billed?
      instructions:
      - text: Validate my API key and show my credit balance using the v1 me endpoint.
      - text: Check how many credits I have left via v1.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/health'].get
  update:
    x-apievangelist-phrasing:
      intent: Check that the v1 API is up
      effect: read
      questions:
      - Is the v1 transcript API currently serving requests?
      - What liveness endpoint can my uptime monitor ping on v1 without a key?
      instructions:
      - text: Ping the v1 health check to confirm the API is up.
      - text: Run a v1 liveness probe for uptime monitoring.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/me'].get
  update:
    x-apievangelist-phrasing:
      intent: Check API key and credit balance (v2)
      effect: read
      questions:
      - How many transcript credits does my account have left on v2?
      - Does the v2 key check confirm my credentials work in an integration?
      instructions:
      - text: Validate my API key and return my remaining credit balance with the v2 me endpoint.
      - text: Show my current credit balance from the v2 API.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/health'].get
  update:
    x-apievangelist-phrasing:
      intent: Check that the v2 API is up
      effect: read
      questions:
      - Is the v2 API healthy right now?
      - Which v2 endpoint returns 200 whenever the service is up, with no credits used?
      instructions:
      - text: Hit the v2 health endpoint and tell me if it returns 200.
      - text: Confirm the v2 transcript service is live.
      method: generated
      generated: '2026-10-01'