> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trugen.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Speak

> Send a text message to an active conversation and the agent will speak it aloud.



## OpenAPI

````yaml PUT /v1/conversation/{conversation_id}/speak
openapi: 3.0.3
info:
  title: TruGen Developer Platform API
  version: 1.0.0
  description: OpenAPI specification for MCP endpoint
servers:
  - url: https://api.trugen.ai/v1
security: []
paths:
  /v1/conversation/{conversation_id}/speak:
    put:
      summary: Speak
      description: >-
        Send a text message to an active conversation and the agent will speak
        it aloud.
      operationId: conversationSpeak
      parameters:
        - name: conversation_id
          in: path
          required: true
          description: The unique identifier of the active conversation.
          schema:
            type: string
            example: conv_abc123
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - text
              properties:
                text:
                  type: string
                  description: The text the agent should speak in the conversation.
                  example: Hello, Hi from team trugen.
      responses:
        '200':
          description: The agent has spoken the provided text.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Agent is speaking the provided text.
        '401':
          description: Unauthorized – invalid or missing API key
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
              example:
                error: 'Unauthorized: not a valid authorization api key'
        '404':
          description: Conversation not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
              example:
                error: Conversation not found
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
              example:
                error: Failed to process speak request
      security:
        - apiKeyAuth: []
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````