> This page is for APIs.

> Fetch clean Markdown by appending `.md` to any page URL under https://signalwire.com/docs or requesting it with the HTTP header `Accept: text/markdown`. The root index at https://signalwire.com/docs/llms.txt lists the available documentation indexes.

# ai.translate.conversation_log

GET /

Receive ai.translate.conversation_log events

Reference: https://signalwire.com/docs/apis/relay/client/fabric/ai-translate-conversation-log

## AsyncAPI Specification

```yaml
asyncapi: 2.6.0
info:
  title: ai.translate.conversation_log
  version: subpackage_aiTranslateConversationLog.ai.translate.conversation_log
  description: Receive ai.translate.conversation_log events
channels:
  /:
    description: Receive ai.translate.conversation_log events
    publish:
      operationId: >-
        subpackage_aiTranslateConversationLog.ai.translate.conversation_log-publish
      summary: ai.translate.conversation_log
      message:
        name: onAiTranslateConversationLogFabricAiTranslateConversationLogEvent
        title: ai.translate.conversation_log
        payload:
          $ref: >-
            #/components/schemas/ai.translate.conversation_log_fabricAiTranslateConversationLogEvent
servers:
  production:
    url: wss://relay.signalwire.com/
    protocol: wss
    x-default: true
components:
  schemas:
    ChannelsAiTranslateConversationLogMessagesFabricAiTranslateConversationLogEventJsonrpc:
      type: string
      enum:
        - '2.0'
      description: JSON-RPC version. Always `2.0`.
      title: >-
        ChannelsAiTranslateConversationLogMessagesFabricAiTranslateConversationLogEventJsonrpc
    ChannelsAiTranslateConversationLogMessagesFabricAiTranslateConversationLogEventMethod:
      type: string
      enum:
        - signalwire.event
      description: Always `signalwire.event`.
      title: >-
        ChannelsAiTranslateConversationLogMessagesFabricAiTranslateConversationLogEventMethod
    ChannelsAiTranslateConversationLogMessagesFabricAiTranslateConversationLogEventParamsEventType:
      type: string
      enum:
        - ai.translate.conversation_log
      description: The event type — identifies which event this is.
      title: >-
        ChannelsAiTranslateConversationLogMessagesFabricAiTranslateConversationLogEventParamsEventType
    Calling.ConversationLogEntry:
      type: object
      properties:
        role:
          type: string
          description: >-
            Who spoke this turn: `remote-caller` (the far end) or `local-caller`
            (your side). Tool/function turns use the `tool` role.
        content:
          type: string
          description: The text of this turn.
        confidence:
          type: number
          format: double
          description: >-
            Recognition confidence for this turn, roughly 0.0-1.0. Absent for
            non-speech turns.
        language:
          type: string
          description: BCP-47 language code of this turn (e.g. `en`, `es-ES`).
        filter_type:
          type: string
          description: The kind of content filter that matched this turn, when one did.
        filter_value:
          type: string
          description: The value the content filter matched, when one did.
        tool_call_id:
          type: string
          description: >-
            Correlation id for a tool/function-call turn. Present only on
            `tool`-role entries.
      required:
        - role
        - content
      description: >-
        One turn in a conversation log. Shared by the summary and
        conversation-log events of

        `calling.live_transcribe` and `calling.live_translate`. This is a
        slimmer record than a

        per-utterance result — it carries the turn's text and speaker, not the
        low-level speech-recognition metadata.
      title: Calling.ConversationLogEntry
    CallingTranslateLegDataRole:
      type: string
      enum:
        - local-caller
        - remote-caller
      description: >-
        Which side of the call this entry describes — in the keyed map, the same
        value as its key: `local-caller` (the inbound leg) or `remote-caller`
        (the outbound leg).
      title: CallingTranslateLegDataRole
    CallingTranslateLegDataPosition:
      type: string
      enum:
        - primary
        - secondary
      description: 'This leg''s position in the translation pair: `primary` or `secondary`.'
      title: CallingTranslateLegDataPosition
    Calling.TranslateLegData:
      type: object
      properties:
        from_language:
          type: string
          description: The language spoken on this leg, as a language code (e.g. `en-US`).
        to_language:
          type: string
          description: >-
            The language this leg is translated into, as a language code (e.g.
            `es-ES`).
        to_voice:
          type: string
          description: The voice used to speak this leg's translated audio.
        role:
          $ref: '#/components/schemas/CallingTranslateLegDataRole'
          description: >-
            Which side of the call this entry describes — in the keyed map, the
            same value as its key: `local-caller` (the inbound leg) or
            `remote-caller` (the outbound leg).
        position:
          $ref: '#/components/schemas/CallingTranslateLegDataPosition'
          description: >-
            This leg's position in the translation pair: `primary` or
            `secondary`.
        translate_filter:
          type: string
          description: >-
            The tone/style filter applied to this leg's translation. Present
            only when a filter was configured.
      required:
        - from_language
        - to_language
        - to_voice
        - role
        - position
      description: >-
        The translation settings for one call leg, as echoed on the
        `calling.ai.translate.conversation_log` event.
      title: Calling.TranslateLegData
    FabricFabricAiTranslateConversationLogParamsTranslateData1:
      type: object
      additionalProperties:
        $ref: '#/components/schemas/Calling.TranslateLegData'
      title: FabricFabricAiTranslateConversationLogParamsTranslateData1
    FabricFabricAiTranslateConversationLogParamsTranslateData:
      oneOf:
        - $ref: '#/components/schemas/Calling.TranslateLegData'
        - $ref: >-
            #/components/schemas/FabricFabricAiTranslateConversationLogParamsTranslateData1
        - description: Any type
      description: >-
        Translation settings. The shape depends on how the session was started:
        with

        `ai_summary`, a single `TranslateLegData` object for this leg; otherwise
        a map

        keyed by leg role (`local-caller` = the inbound leg, `remote-caller` =
        the

        outbound leg), or `null` if nothing was translated.
      title: FabricFabricAiTranslateConversationLogParamsTranslateData
    Calling.AiCallInfo:
      type: object
      properties:
        project_id:
          type: string
          description: Your project ID.
        space_id:
          type: string
          description: Your space ID.
        content_type:
          type: string
          description: The content type of the delivery.
        content_disposition:
          type: string
          description: The content disposition of the delivery.
        conversation_type:
          type: string
          description: The kind of conversation this delivery describes.
        call_id:
          type: string
          description: The call ID.
      required:
        - content_type
        - content_disposition
        - conversation_type
        - call_id
      description: >-
        Call/session context attached to AI transcribe, translate, and sidecar
        webhook deliveries, as a

        sibling of the documented event fields. Added on every delivery.
      title: Calling.AiCallInfo
    Calling.AiChannelData:
      type: object
      properties:
        project_id:
          type: string
          description: Your project ID.
        space_id:
          type: string
          description: Your space ID.
        content_type:
          type: string
          description: The content type of the delivery.
        content_disposition:
          type: string
          description: The content disposition of the delivery.
        call_id:
          type: string
          description: The call ID.
        call_start_date:
          type: integer
          format: int64
          description: When the call started, as a Unix timestamp in microseconds.
        call_answer_date:
          type: integer
          format: int64
          description: >-
            When the call was answered, as a Unix timestamp in microseconds. `0`
            if not answered yet.
        call_end_date:
          type: integer
          format: int64
          description: >-
            When the call ended, as a Unix timestamp in microseconds. `0` while
            the call is still up.
        caller_id_name:
          type: string
          description: The caller's name.
        caller_id_number:
          type: string
          description: The caller's number.
        SWMLVars:
          type: object
          additionalProperties:
            description: Any type
          description: >-
            Custom variables set on the call during its SWML execution, as
            name/value pairs.
        SWMLCall:
          type: object
          additionalProperties:
            description: Any type
          description: >-
            The SWML `call` object for this call — the call metadata (direction,
            from/to, headers, timing) available to your SWML document. See the
            SWML reference for its fields.
      required:
        - content_type
        - content_disposition
        - call_id
      description: >-
        Extended call/channel context attached to AI transcribe and translate
        deliveries — a superset of

        `AiCallInfo` with call timing and caller-ID detail.
      title: Calling.AiChannelData
    Fabric.FabricAiTranslateConversationLogParams:
      type: object
      properties:
        call_id:
          type: string
          description: >-
            Unique identifier of the call this event is about. Always present on
            Fabric events.
        node_id:
          type: string
          description: The node the call leg lives on.
        room_session_id:
          type: string
          description: >-
            The room session this call leg belongs to. In a 1:1 call this equals
            the `call_id`.
        segment_id:
          type: string
          description: >-
            Identifier of the call segment this event belongs to, for
            correlating events within the same segment.
        tag:
          type: string
          description: >-
            The `tag` the leg was dialed with, when a server-side application
            set one on the dial. Absent otherwise.
        primary_conversation_log:
          type: array
          items:
            $ref: '#/components/schemas/Calling.ConversationLogEntry'
          description: The source-language conversation, one entry per turn.
        primary_conversation_summary:
          type: string
          description: >-
            An AI-generated summary of the source-language side. Present only
            when the session was started with AI summary enabled.
        secondary_conversation_log:
          type: array
          items:
            $ref: '#/components/schemas/Calling.ConversationLogEntry'
          description: The translated conversation, one entry per turn.
        secondary_conversation_summary:
          type: string
          description: >-
            An AI-generated summary of the translated side. Present only when
            the session was started with AI summary enabled.
        translate_data:
          $ref: >-
            #/components/schemas/FabricFabricAiTranslateConversationLogParamsTranslateData
          description: >-
            Translation settings. The shape depends on how the session was
            started: with

            `ai_summary`, a single `TranslateLegData` object for this leg;
            otherwise a map

            keyed by leg role (`local-caller` = the inbound leg, `remote-caller`
            = the

            outbound leg), or `null` if nothing was translated.
        call_info:
          $ref: '#/components/schemas/Calling.AiCallInfo'
          description: Call/session context for this delivery.
        channel_data:
          $ref: '#/components/schemas/Calling.AiChannelData'
          description: Extended call/channel context for this delivery.
      required:
        - call_id
        - node_id
        - room_session_id
        - primary_conversation_log
        - secondary_conversation_log
        - translate_data
        - call_info
        - channel_data
      title: Fabric.FabricAiTranslateConversationLogParams
    ChannelsAiTranslateConversationLogMessagesFabricAiTranslateConversationLogEventParams:
      type: object
      properties:
        event_type:
          $ref: >-
            #/components/schemas/ChannelsAiTranslateConversationLogMessagesFabricAiTranslateConversationLogEventParamsEventType
          description: The event type — identifies which event this is.
        event_channel:
          type: string
          description: >-
            The channel the event was delivered on — for Calling events, the
            `protocol`

            string your connection received from `signalwire.connect`.
        timestamp:
          type: number
          format: double
          description: >-
            When the event was emitted, as a Unix timestamp in seconds. Always
            present.
        project_id:
          type: string
          description: >-
            Your project ID. Present on Calling events and most Call Fabric
            events; absent on `call.joined`, `call.left`, `member.joined`, and
            `member.left`.
        space_id:
          type: string
          description: >-
            Your space ID. Present on Calling events and most Call Fabric
            events; absent on `call.joined`, `call.left`, `member.joined`, and
            `member.left`.
        params:
          $ref: '#/components/schemas/Fabric.FabricAiTranslateConversationLogParams'
          description: The event-specific payload.
      required:
        - event_type
        - event_channel
        - timestamp
        - params
      description: The event envelope.
      title: >-
        ChannelsAiTranslateConversationLogMessagesFabricAiTranslateConversationLogEventParams
    ai.translate.conversation_log_fabricAiTranslateConversationLogEvent:
      type: object
      properties:
        jsonrpc:
          $ref: >-
            #/components/schemas/ChannelsAiTranslateConversationLogMessagesFabricAiTranslateConversationLogEventJsonrpc
          description: JSON-RPC version. Always `2.0`.
        id:
          type: string
          description: >-
            Event id — a unique UUID generated for each event. Events are
            notifications: you do not reply to them.
        method:
          $ref: >-
            #/components/schemas/ChannelsAiTranslateConversationLogMessagesFabricAiTranslateConversationLogEventMethod
          description: Always `signalwire.event`.
        params:
          $ref: >-
            #/components/schemas/ChannelsAiTranslateConversationLogMessagesFabricAiTranslateConversationLogEventParams
          description: The event envelope.
      required:
        - jsonrpc
        - id
        - method
        - params
      description: >-
        Fires on a Call Fabric call leg when live translation delivers its
        conversation log. Same fields as the Calling API's
        `calling.ai.translate.conversation_log` event. SWML or a server-side
        application starts live translation on the leg; there is no client
        request that starts it.
      title: ai.translate.conversation_log_fabricAiTranslateConversationLogEvent

```