API Evangelist conversational phrasing for ElevenLabs API Documentation Agents Platform API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for ElevenLabs API Documentation Agents Platform API
  version: 1.0.0
extends: openapi/elevenlabs-agents-platform-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: 150
- target: $.paths['/v1/convai/conversation/get-signed-url'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a signed URL to talk to a private agent
      effect: read
      questions:
      - How do I start a conversation with an agent that requires authorization?
      - Can the signed conversation URL also hand back the conversation ID up front?
      instructions:
      - text: Get a signed conversation URL for agent {agent_id}.
        slots:
          agent_id: query.agent_id
      - text: Create a signed URL for agent {agent_id} on branch {branch_id} and include the conversation ID.
        slots:
          agent_id: query.agent_id
          branch_id: query.branch_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/convai/conversation/get_signed_url'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a signed agent URL via the legacy endpoint
      effect: read
      questions:
      - Is the underscore get_signed_url path still usable for private agents?
      - What does the deprecated signed URL endpoint return for an authorized agent?
      instructions:
      - text: Use the legacy get_signed_url endpoint to sign a conversation URL for agent {agent_id}.
        slots:
          agent_id: query.agent_id
      - text: Call the deprecated signed URL route for agent {agent_id} in environment {environment}.
        slots:
          agent_id: query.agent_id
          environment: query.environment
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/convai/conversation/token'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a WebRTC token for a live agent session
      effect: read
      questions:
      - How can my app open a real-time WebRTC voice session with an agent?
      - Can I set the participant name on the WebRTC session token?
      instructions:
      - text: Get a WebRTC session token for agent {agent_id}.
        slots:
          agent_id: query.agent_id
      - text: Issue a WebRTC token for agent {agent_id} with participant name {participant_name}.
        slots:
          agent_id: query.agent_id
          participant_name: query.participant_name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/convai/twilio/outbound-call'].post
  update:
    x-apievangelist-phrasing:
      intent: Place an outbound agent call through Twilio
      effect: write
      questions:
      - How do I have my voice agent dial a customer using a Twilio number?
      - Can a Twilio outbound agent call be recorded?
      instructions:
      - text: Have agent {agent_id} call {to_number} from Twilio number {agent_phone_number_id}.
        slots:
          agent_id: requestBody.agent_id
          to_number: requestBody.to_number
          agent_phone_number_id: requestBody.agent_phone_number_id
      - text: Place a recorded Twilio call to {to_number} with agent {agent_id} using phone number {agent_phone_number_id}.
        slots:
          to_number: requestBody.to_number
          agent_id: requestBody.agent_id
          agent_phone_number_id: requestBody.agent_phone_number_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/convai/twilio/register-call'].post
  update:
    x-apievangelist-phrasing:
      intent: Register a Twilio call and get TwiML back
      effect: write
      questions:
      - What TwiML do I return to connect a Twilio call I manage myself to an agent?
      - Can I register an inbound Twilio call with an agent and get the connecting TwiML?
      instructions:
      - text: Register the Twilio call from {from_number} to {to_number} with agent {agent_id} and return TwiML.
        slots:
          from_number: requestBody.from_number
          to_number: requestBody.to_number
          agent_id: requestBody.agent_id
      - text: Register a {direction} Twilio call between {from_number} and {to_number} for agent {agent_id}.
        slots:
          direction: requestBody.direction
          from_number: requestBody.from_number
          to_number: requestBody.to_number
          agent_id: requestBody.agent_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/convai/exotel/outbound-call'].post
  update:
    x-apievangelist-phrasing:
      intent: Place an outbound agent call through Exotel
      effect: write
      questions:
      - How can my agent dial out using an Exotel phone number?
      - Which fields does an Exotel outbound agent call need?
      instructions:
      - text: Call {to_number} via Exotel with agent {agent_id} from number {agent_phone_number_id}.
        slots:
          to_number: requestBody.to_number
          agent_id: requestBody.agent_id
          agent_phone_number_id: requestBody.agent_phone_number_id
      - text: Start an Exotel outbound call from agent {agent_id} to {to_number} on {agent_phone_number_id}.
        slots:
          agent_id: requestBody.agent_id
          to_number: requestBody.to_number
          agent_phone_number_id: requestBody.agent_phone_number_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/convai/whatsapp/outbound-call'].post
  update:
    x-apievangelist-phrasing:
      intent: Place an outbound agent voice call on WhatsApp
      effect: write
      questions:
      - Can my agent call a customer over WhatsApp voice?
      - Which permission request template is needed before an agent calls on WhatsApp?
      instructions:
      - text: Voice-call WhatsApp user {whatsapp_user_id} from {whatsapp_phone_number_id} with agent {agent_id}.
        slots:
          whatsapp_user_id: requestBody.whatsapp_user_id
          whatsapp_phone_number_id: requestBody.whatsapp_phone_number_id
          agent_id: requestBody.agent_id
      - text: Ring WhatsApp user {whatsapp_user_id} with agent {agent_id}.
        slots:
          whatsapp_user_id: requestBody.whatsapp_user_id
          agent_id: requestBody.agent_id
      - text: Ask for call permission with template {whatsapp_call_permission_request_template_name} before the WhatsApp agent call.
        slots:
          whatsapp_call_permission_request_template_name: requestBody.whatsapp_call_permission_request_template_name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/convai/whatsapp/outbound-message'].post
  update:
    x-apievangelist-phrasing:
      intent: Send a WhatsApp template message from an agent
      effect: write
      questions:
      - How do I have an agent start a WhatsApp chat with a template message?
      - Can I fill template parameters when my agent messages someone on WhatsApp?
      instructions:
      - text: Send WhatsApp template {template_name} to user {whatsapp_user_id} for agent {agent_id} with params {template_params}.
        slots:
          template_name: requestBody.template_name
          whatsapp_user_id: requestBody.whatsapp_user_id
          agent_id: requestBody.agent_id
          template_params: requestBody.template_params
      - text: Message WhatsApp user {whatsapp_user_id} using template {template_name}.
        slots:
          whatsapp_user_id: requestBody.whatsapp_user_id
          template_name: requestBody.template_name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/convai/agents/create'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a conversational agent
      effect: write
      questions:
      - How do I create a new voice agent from a config object?
      - Can I turn on versioning when I first create an agent?
      instructions:
      - text: Create an agent named {name} with conversation config {conversation_config}.
        slots:
          name: requestBody.name
          conversation_config: requestBody.conversation_config
      - text: Build a new agent tagged {tags} from config {conversation_config}.
        slots:
          tags: requestBody.tags
          conversation_config: requestBody.conversation_config
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/convai/agents/summaries'].get
  update:
    x-apievangelist-phrasing:
      intent: Get summaries for several agents at once
      effect: read
      questions:
      - Can I fetch short summaries for a batch of agent IDs in one call?
      - What summary info comes back when I pass a list of agents?
      instructions:
      - text: Get summaries for agents {agent_ids}.
        slots:
          agent_ids: query.agent_ids
      - text: 'Summarize this set of agents: {agent_ids}.'
        slots:
          agent_ids: query.agent_ids
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/convai/agents/{agent_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an agent's configuration
      effect: read
      questions:
      - How can I see the full config of one of my agents?
      - Can I read an agent's config at a specific version or branch?
      instructions:
      - text: Show the configuration for agent {agent_id}.
        slots:
          agent_id: path.agent_id
      - text: Get agent {agent_id} config as of version {version_id}.
        slots:
          agent_id: path.agent_id
          version_id: query.version_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/convai/agents/{agent_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an agent
      effect: destructive
      questions:
      - How do I permanently remove an agent I no longer need?
      - What happens when I delete a conversational agent?
      instructions:
      - text: Delete agent {agent_id}.
        slots:
          agent_id: path.agent_id
      - text: Remove the agent {agent_id} from my account.
        slots:
          agent_id: path.agent_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/convai/agents/{agent_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an agent's settings
      effect: write
      questions:
      - How do I change the prompt or voice settings of an existing agent?
      - Can I add a version description when I update an agent?
      instructions:
      - text: Rename agent {agent_id} to {name}.
        slots:
          agent_id: path.agent_id
          name: requestBody.name
      - text: Update agent {agent_id} conversation config to {conversation_config} on branch {branch_id}.
        slots:
          agent_id: path.agent_id
          conversation_config: requestBody.conversation_config
          branch_id: query.branch_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/convai/agents/{agent_id}/widget'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an agent's embeddable widget config
      effect: read
      questions:
      - What widget settings are used when I embed an agent on my website?
      - Can I fetch the widget config with a conversation signature?
      instructions:
      - text: Get the widget configuration for agent {agent_id}.
        slots:
          agent_id: path.agent_id
      - text: Fetch the embed widget config of agent {agent_id} using signature {conversation_signature}.
        slots:
          agent_id: path.agent_id
          conversation_signature: query.conversation_signature
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/convai/agents/{agent_id}/link'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an agent's shareable link
      effect: read
      questions:
      - Is there a link I can send people so they can try my agent?
      - Where do I find the current share URL for an agent?
      instructions:
      - text: Get the shareable link for agent {agent_id}.
        slots:
          agent_id: path.agent_id
      - text: Give me the public share URL of agent {agent_id}.
        slots:
          agent_id: path.agent_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/convai/agents/{agent_id}/avatar'].post
  update:
    x-apievangelist-phrasing:
      intent: Set an agent's widget avatar
      effect: write
      questions:
      - How do I upload a profile picture for my agent's widget?
      - Can I change the avatar shown in the embedded agent widget?
      instructions:
      - text: Set the avatar of agent {agent_id} to {avatar_file}.
        slots:
          agent_id: path.agent_id
          avatar_file: requestBody.avatar_file
      - text: Upload {avatar_file} as the widget image for agent {agent_id}.
        slots:
          avatar_file: requestBody.avatar_file
          agent_id: path.agent_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/convai/agents/{agent_id}/hold-audio'].post
  update:
    x-apievangelist-phrasing:
      intent: Upload custom hold music for queued callers
      effect: write
      questions:
      - Can callers waiting in my agent's queue hear my own hold music?
      - Does uploading new hold audio replace the previous clip?
      instructions:
      - text: Set {hold_audio_file} as the hold audio for agent {agent_id}.
        slots:
          hold_audio_file: requestBody.hold_audio_file
          agent_id: path.agent_id
      - text: Replace the waiting-queue hold clip on agent {agent_id} with {hold_audio_file}.
        slots:
          agent_id: path.agent_id
          hold_audio_file: requestBody.hold_audio_file
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/convai/agents/{agent_id}/hold-audio'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove an agent's custom hold audio
      effect: destructive
      questions:
      - How do I go back to the default hold tone for queued callers?
      - Can I remove the custom hold clip I uploaded for an agent?
      instructions:
      - text: Remove the custom hold audio from agent {agent_id}.
        slots:
          agent_id: path.agent_id
      - text: Restore the default hold tone on agent {agent_id}.
        slots:
          agent_id: path.agent_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/convai/agents'].get
  update:
    x-apievangelist-phrasing:
      intent: List my agents
      effect: read
      questions:
      - Which conversational agents do I have in my workspace?
      - Can I search my agents by name or include archived ones?
      - Is it possible to list only the agents I created, filtered by tag?
      instructions:
      - text: List all my agents.
      - text: Find agents matching {search}.
        slots:
          search: query.search
      - text: List agents tagged {tags}, only ones I own.
        slots:
          tags: query.tags
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/convai/agent/{agent_id}/knowledge-base/size'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the page count of an agent's knowledge base
      effect: read
      questions:
      - How many pages are in my agent's knowledge base?
      - What's the size of the knowledge attached to one agent?
      instructions:
      - text: Count knowledge base pages for agent {agent_id}.
        slots:
          agent_id: path.agent_id
      - text: Tell me how big agent {agent_id}'s knowledge base is.
        slots:
          agent_id: path.agent_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/convai/agent/{agent_id}/llm-usage/calculate'].post
  update:
    x-apievangelist-phrasing:
      intent: Estimate LLM token usage for a specific agent
      effect: read
      questions:
      - How many LLM tokens will one of my agents likely use?
      - Does enabling RAG change the expected token count for my agent?
      instructions:
      - text: Estimate LLM token usage for agent {agent_id}.
        slots:
          agent_id: path.agent_id
      - text: Calculate expected tokens for agent {agent_id} with a {prompt_length} character prompt and {number_of_pages} knowledge pages.
        slots:
          agent_id: path.agent_id
          prompt_length: requestBody.prompt_length
          number_of_pages: requestBody.number_of_pages
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/convai/agents/{agent_id}/duplicate'].post
  update:
    x-apievangelist-phrasing:
      intent: Duplicate an existing agent
      effect: write
      questions:
      - Can I clone an agent to experiment without touching the original?
      - How do I copy an agent and give the copy a new name?
      instructions:
      - text: Duplicate agent {agent_id}.
        slots:
          agent_id: path.agent_id
      - text: Clone agent {agent_id} as {name}.
        slots:
          agent_id: path.agent_id
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/convai/agents/{agent_id}/simulate-conversation'].post
  update:
    x-apievangelist-phrasing:
      intent: Simulate a conversation with an agent (deprecated)
      effect: write
      questions:
      - Can I run a whole conversation between my agent and a simulated user and get the result?
      - Is there a turn limit on a simulated agent conversation?
      instructions:
      - text: Simulate a conversation with agent {agent_id} using spec {simulation_specification}.
        slots:
          agent_id: path.agent_id
          simulation_specification: requestBody.simulation_specification
      - text: Run a simulated chat on agent {agent_id} capped at {new_turns_limit} turns with spec {simulation_specification}.
        slots:
          agent_id: path.agent_id
          new_turns_limit: requestBody.new_turns_limit
          simulation_specification: requestBody.simulation_specification
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/convai/agents/{agent_id}/simulate-conversation/stream'].post
  update:
    x-apievangelist-phrasing:
      intent: Stream a simulated agent conversation (deprecated)
      effect: write
      questions:
      - Can I watch a simulated user conversation with my agent stream in as it happens?
      - Is there a streaming version of the agent conversation simulator?
      instructions:
      - text: Stream a simulated conversation for agent {agent_id} using spec {simulation_specification}.
        slots:
          agent_id: path.agent_id
          simulation_specification: requestBody.simulation_specification
      - text: Stream the simulation of agent {agent_id} with extra evaluation criteria {extra_evaluation_criteria} and spec {simulation_specification}.
        slots:
          agent_id: path.agent_id
          extra_evaluation_criteria: requestBody.extra_evaluation_criteria
          simulation_specification: requestBody.simulation_specification
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/convai/agent-testing/folders'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a folder for agent tests
      effect: write
      questions:
      - How do I organize my agent tests into folders?
      - Can I nest a new test folder inside another one?
      instructions:
      - text: Create an agent test folder named {name}.
        slots:
          name: requestBody.name
      - text: Make test folder {name} inside folder {parent_folder_id}.
        slots:
          name: requestBody.name
          parent_folder_id: requestBody.parent_folder_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/convai/agent-testing/folders/{folder_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an agent test folder
      effect: read
      questions:
      - What's the full path of one of my agent test folders?
      - Can I look up a test folder by its ID?
      instructions:
      - text: Get agent test folder {folder_id}.
        slots:
          folder_id: path.folder_id
      - text: Show the folder path of test folder {folder_id}.
        slots:
          folder_id: path.folder_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/convai/agent-testing/folders/{folder_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an agent test folder
      effect: destructive
      questions:
      - How do I delete a test folder that still has tests in it?
      - Can I remove an empty agent test folder?
      instructions:
      - text: Delete test folder {folder_id}.
        slots:
          folder_id: path.folder_id
      - text: Force-delete test folder {folder_id} and everything in it.
        slots:
          folder_id: path.folder_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/convai/agent-testing/folders/{folder_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Rename an agent test folder
      effect: write
      questions:
      - Can I rename one of my agent test folders?
      - What can I change on an existing test folder?
      instructions:
      - text: Rename test folder {folder_id} to {name}.
        slots:
          folder_id: path.folder_id
          name: requestBody.name
      - text: Change the name of agent test folder {folder_id} to {name}.
        slots:
          folder_id: path.folder_id
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/convai/agent-testing/bulk-move'].post
  update:
    x-apievangelist-phrasing:
      intent: Move several agent tests to another folder
      effect: write
      questions:
      - How do I move a batch of agent tests into a different folder?
      - Can I move folders and tests together in one request?
      instructions:
      - text: Move tests {entity_ids} into folder {move_to}.
        slots:
          entity_ids: requestBody.entity_ids
          move_to: requestBody.move_to
      - text: Bulk move {entity_ids} to the root test folder.
        slots:
          entity_ids: requestBody.entity_ids
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/convai/conversations'].get
  update:
    x-apievangelist-phrasing:
      intent: List my agents' conversations
      effect: read
      questions:
      - Which conversations have my agents had recently?
      - Can I filter agent conversations by success, duration or rating?
      - Is there a way to list only calls that started after a certain date?
      instructions:
      - text: List conversations for agent {agent_id}.
        slots:
          agent_id: query.agent_id
      - text: Show unsuccessful conversations started after {call_start_after_unix}.
        slots:
          call_start_after_unix: query.call_start_after_unix
      - text: List conversations longer than {call_duration_min_secs} seconds with rating at most {rating_max}.
        slots:
          call_duration_min_secs: query.call_duration_min_secs
          rating_max: query.rating_max
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/convai/users'].get
  update:
    x-apievangelist-phrasing:
      intent: List distinct users who talked to my agents
      effect: read
      questions:
      - Who are the unique end users that have spoken with my agent?
      - Can I search the people my agent has talked to within a date range?
      instructions:
      - text: List distinct conversation users for agent {agent_id}.
        slots:
          agent_id: query.agent_id
      - text: Find conversation users matching {search}.
        slots:
          search: query.search
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/convai/conversations/resolve'].get
  update:
    x-apievangelist-phrasing:
      intent: Resolve a Slack or Zendesk URL to a conversation
      effect: read
      questions:
      - Which agent conversation came from this Zendesk ticket?
      - Can I turn a Slack message URL into the matching conversation ID?
      instructions:
      - text: Resolve {reference} to a conversation for agent {agent_id}.
        slots:
          reference: query.reference
          agent_id: query.agent_id
      - text: Find the conversation ID behind Slack link {reference} for agent {agent_id}.
        slots:
          reference: query.reference
          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 full details
      effect: read
      questions:
      - How do I pull the full transcript and metadata of one agent conversation?
      - Can I choose the format of a conversation's details?
      instructions:
      - text: Get the details of conversation {conversation_id}.
        slots:
          conversation_id: path.conversation_id
      - text: Show the full transcript of conversation {conversation_id} in {format} format.
        slots:
          conversation_id: path.conversation_id
          format: query.format
      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 conversation record from my agent's history?
      - Can I permanently remove a single agent conversation?
      instructions:
      - text: Delete conversation {conversation_id}.
        slots:
          conversation_id: path.conversation_id
      - text: Erase agent conversation {conversation_id} from history.
        slots:
          conversation_id: path.conversation_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/convai/conversations/{conversation_id}/summary'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a lightweight summary of a conversation
      effect: read
      questions:
      - What's the title and short summary of one agent call, without the whole transcript?
      - Was a given conversation successful, at a glance?
      instructions:
      - text: Summarize conversation {conversation_id}.
        slots:
          conversation_id: path.conversation_id
      - text: Get a quick summary of conversation {conversation_id} with up to {max_messages} messages.
        slots:
          conversation_id: path.conversation_id
          max_messages: query.max_messages
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/convai/conversations/{conversation_id}/sip-messages'].get
  update:
    x-apievangelist-phrasing:
      intent: Get SIP messages for a conversation's call
      effect: read
      questions:
      - Can I see the SIP signaling for a specific agent phone call?
      - How do I debug the SIP exchange behind one conversation?
      instructions:
      - text: Get SIP messages for conversation {conversation_id}.
        slots:
          conversation_id: path.conversation_id
      - text: Show the SIP log of conversation {conversation_id}, {page_size} per page.
        slots:
          conversation_id: path.conversation_id
          page_size: query.page_size
      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:
      - How do I download the recording of an agent conversation?
      - Is the audio of each conversation available to listen back to?
      instructions:
      - text: Download the audio of conversation {conversation_id}.
        slots:
          conversation_id: path.conversation_id
      - text: Get the call recording for conversation {conversation_id}.
        slots:
          conversation_id: path.conversation_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/convai/conversations/{conversation_id}/feedback'].post
  update:
    x-apievangelist-phrasing:
      intent: Send feedback on a conversation
      effect: write
      questions:
      - Can I mark an agent conversation as good or bad?
      - How do I submit feedback for a specific conversation?
      instructions:
      - text: Send feedback {feedback} for conversation {conversation_id}.
        slots:
          feedback: requestBody.feedback
          conversation_id: path.conversation_id
      - text: Rate conversation {conversation_id} as {feedback}.
        slots:
          conversation_id: path.conversation_id
          feedback: requestBody.feedback
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/convai/conversations/messages/text-search'].get
  update:
    x-apievangelist-phrasing:
      intent: Keyword search across conversation transcripts
      effect: read
      questions:
      - Can I find every conversation where a caller said a specific phrase?
      - Does transcript keyword search tolerate typos with fuzzy matching?
      instructions:
      - text: Search conversation transcripts for the words {text_query}.
        slots:
          text_query: query.text_query
      - text: Full-text search agent {agent_id}'s transcripts for {text_query}.
        slots:
          agent_id: query.agent_id
          text_query: query.text_query
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/convai/conversations/messages/smart-search'].get
  update:
    x-apievangelist-phrasing:
      intent: Semantic search across conversation transcripts
      effect: read
      questions:
      - Can I find transcript messages by meaning rather than exact words?
      - Which conversations talk about a topic even if they phrase it differently?
      instructions:
      - text: Semantically search transcripts for messages about {text_query}.
        slots:
          text_query: query.text_query
      - text: Smart search agent {agent_id}'s conversations for intent like {text_query}.
        slots:
          agent_id: query.agent_id
          text_query: query.text_query
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/convai/conversations/{conversation_id}/tags'].post
  update:
    x-apievangelist-phrasing:
      intent: Tag a conversation
      effect: write
      questions:
      - How do I label a conversation with one or more of my workspace tags?
      - What happens if I assign a tag that's already on the conversation?
      instructions:
      - text: Add tags {tag_ids} to conversation {conversation_id}.
        slots:
          tag_ids: requestBody.tag_ids
          conversation_id: path.conversation_id
      - text: Label conversation {conversation_id} with tag {tag_ids}.
        slots:
          conversation_id: path.conversation_id
          tag_ids: requestBody.tag_ids
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/convai/conversations/{conversation_id}/tags/{tag_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a tag from a conversation
      effect: destructive
      questions:
      - Can I take a single tag off one conversation without deleting the tag?
      - How do I untag a conversation?
      instructions:
      - text: Remove tag {tag_id} from conversation {conversation_id}.
        slots:
          tag_id: path.tag_id
          conversation_id: path.conversation_id
      - text: Untag conversation {conversation_id}, dropping {tag_id}.
        slots:
          conversation_id: path.conversation_id
          tag_id: path.tag_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/convai/tags'].get
  update:
    x-apievangelist-phrasing:
      intent: List the workspace's conversation tags
      effect: read
      questions:
      - Which conversation tags exist in my workspace?
      - What labels are available for tagging agent calls, newest first?
      instructions:
      - text: List all conversation tags in my workspace.
      - text: Show the {page_size} most recently created conversation tags.
        slots:
          page_size: query.page_size
      method: generated
      generated: '2026-09-26'


# --- truncated at 32 KB (107 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/elevenlabs/refs/heads/main/overlays/elevenlabs-agents-platform-api-phrasing-overlay.yaml