# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for ElevenLabs Conversational AI Conversations API
  version: 1.0.0
extends: openapi/elevenlabs-conversations-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['/v1/convai/conversations'].get
  update:
    x-apievangelist-phrasing:
      intent: List agent conversations
      effect: read
      questions:
      - What conversations have my voice agents had recently?
      - Can I see only the conversations handled by one particular agent?
      instructions:
      - text: List my recent agent conversations.
      - text: List conversations handled by agent {agent_id}.
        slots:
          agent_id: query.agent_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/convai/conversations/{conversation_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a conversation's transcript and analysis
      effect: read
      questions:
      - Can I read the full transcript of a call my agent handled?
      - Where do I find the analysis and metadata for one conversation?
      instructions:
      - text: Get the transcript and analysis of conversation {conversation_id}.
        slots:
          conversation_id: path.conversation_id
      - text: Show me what was said in conversation {conversation_id}.
        slots:
          conversation_id: path.conversation_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/convai/conversations/{conversation_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a conversation
      effect: destructive
      questions:
      - How do I delete a stored agent conversation and its data?
      - Can I remove one conversation record for privacy reasons?
      instructions:
      - text: Delete conversation {conversation_id}.
        slots:
          conversation_id: path.conversation_id
      - text: Erase conversation {conversation_id} and its associated data.
        slots:
          conversation_id: path.conversation_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/convai/conversations/{conversation_id}/audio'].get
  update:
    x-apievangelist-phrasing:
      intent: Download a conversation's audio recording
      effect: read
      questions:
      - Can I listen to the recording of a call my agent took?
      - How do I download the audio of one agent conversation?
      instructions:
      - text: Download the audio of conversation {conversation_id}.
        slots:
          conversation_id: path.conversation_id
      - text: Get the call recording for {conversation_id}.
        slots:
          conversation_id: path.conversation_id
      method: generated
      generated: '2026-09-26'