> 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.

# calling.live_translate

GET /

Start, stop, summarize, or inject into live translation on a call

Reference: https://signalwire.com/docs/apis/relay/server/calling/calling-live-translate

## AsyncAPI Specification

```yaml
asyncapi: 2.6.0
info:
  title: calling.live_translate
  version: subpackage_callingLiveTranslate.calling.live_translate
  description: Start, stop, summarize, or inject into live translation on a call
channels:
  /:
    description: Start, stop, summarize, or inject into live translation on a call
    publish:
      operationId: subpackage_callingLiveTranslate.calling.live_translate-publish
      summary: Server messages
      message:
        oneOf:
          - $ref: >-
              #/components/messages/subpackage_callingLiveTranslate.calling.live_translate-server-0-onCallingLiveTranslateTranslateTranscriptDeltaEvent
          - $ref: >-
              #/components/messages/subpackage_callingLiveTranslate.calling.live_translate-server-1-onCallingLiveTranslateTranslateLiveSummaryEvent
          - $ref: >-
              #/components/messages/subpackage_callingLiveTranslate.calling.live_translate-server-2-onCallingLiveTranslateTranslateConversationLogEvent
          - $ref: >-
              #/components/messages/subpackage_callingLiveTranslate.calling.live_translate-server-3-onCallingLiveTranslateResponse
    subscribe:
      operationId: subpackage_callingLiveTranslate.calling.live_translate-subscribe
      summary: calling.live_translate
      message:
        name: callingLiveTranslate
        title: calling.live_translate
        payload:
          $ref: >-
            #/components/schemas/calling.live_translate_callingLiveTranslateRequest
servers:
  production:
    url: wss://relay.signalwire.com/
    protocol: wss
    x-default: true
components:
  messages:
    subpackage_callingLiveTranslate.calling.live_translate-server-0-onCallingLiveTranslateTranslateTranscriptDeltaEvent:
      name: onCallingLiveTranslateTranslateTranscriptDeltaEvent
      title: calling.ai.translate.transcript_delta
      payload:
        $ref: >-
          #/components/schemas/calling.live_translate_translateTranscriptDeltaEvent
    subpackage_callingLiveTranslate.calling.live_translate-server-1-onCallingLiveTranslateTranslateLiveSummaryEvent:
      name: onCallingLiveTranslateTranslateLiveSummaryEvent
      title: calling.ai.translate.live_summary
      payload:
        $ref: '#/components/schemas/calling.live_translate_translateLiveSummaryEvent'
    subpackage_callingLiveTranslate.calling.live_translate-server-2-onCallingLiveTranslateTranslateConversationLogEvent:
      name: onCallingLiveTranslateTranslateConversationLogEvent
      title: calling.ai.translate.conversation_log
      payload:
        $ref: >-
          #/components/schemas/calling.live_translate_translateConversationLogEvent
    subpackage_callingLiveTranslate.calling.live_translate-server-3-onCallingLiveTranslateResponse:
      name: onCallingLiveTranslateResponse
      title: calling.live_translate response
      payload:
        $ref: >-
          #/components/schemas/calling.live_translate_callingLiveTranslateResponse
  schemas:
    ChannelsCallingLiveTranslateMessagesTranslateTranscriptDeltaEventJsonrpc:
      type: string
      enum:
        - '2.0'
      description: JSON-RPC version. Always `2.0`.
      title: ChannelsCallingLiveTranslateMessagesTranslateTranscriptDeltaEventJsonrpc
    ChannelsCallingLiveTranslateMessagesTranslateTranscriptDeltaEventMethod:
      type: string
      enum:
        - signalwire.event
      description: Always `signalwire.event`.
      title: ChannelsCallingLiveTranslateMessagesTranslateTranscriptDeltaEventMethod
    ChannelsCallingLiveTranslateMessagesTranslateTranscriptDeltaEventParamsEventType:
      type: string
      enum:
        - calling.ai.translate.transcript_delta
      description: The event type — identifies which event this is.
      title: >-
        ChannelsCallingLiveTranslateMessagesTranslateTranscriptDeltaEventParamsEventType
    Calling.TranslateUtterance:
      type: object
      properties:
        language:
          type: string
          description: >-
            The language of this fragment as a BCP-47 language code (e.g. `en`,
            `es-ES`).
        delta:
          type: string
          description: The incremental text for this fragment.
      required:
        - language
        - delta
      description: An incremental translated (or source) text fragment.
      title: Calling.TranslateUtterance
    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
    Calling.TranslateTranscriptDeltaEventData:
      type: object
      properties:
        node_id:
          type: string
          description: >-
            Opaque identifier that, paired with `call_id`, addresses this call.
            Echo back the value you received; treat it as opaque.
        call_id:
          type: string
          description: Unique identifier of the call.
        segment_id:
          type: string
          description: >-
            Identifier of the call segment this event belongs to, for
            correlating events within the same segment of a call.
        tag:
          type: string
          description: >-
            The `tag` you set when placing the call, echoed back so you can
            match the event to your request.
        input_utterance:
          $ref: '#/components/schemas/Calling.TranslateUtterance'
          description: Present on source-language (input) fragments.
        output_utterance:
          $ref: '#/components/schemas/Calling.TranslateUtterance'
          description: Present on translated (output) fragments.
        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:
        - node_id
        - call_id
        - call_info
        - channel_data
      description: >-
        A live-translation delta delivered while the call is in progress.
        Carries the

        incremental source text (`input_utterance`) and/or the translated text

        (`output_utterance`) as the call proceeds. Sent only in `realtime` mode,
        and only

        when you start `calling.live_translate` with `live_events` enabled and a
        `webhook`

        URL configured.
      title: Calling.TranslateTranscriptDeltaEventData
    ChannelsCallingLiveTranslateMessagesTranslateTranscriptDeltaEventParams:
      type: object
      properties:
        event_type:
          $ref: >-
            #/components/schemas/ChannelsCallingLiveTranslateMessagesTranslateTranscriptDeltaEventParamsEventType
          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/Calling.TranslateTranscriptDeltaEventData'
          description: The event-specific payload.
      required:
        - event_type
        - event_channel
        - timestamp
        - params
      description: The event envelope.
      title: ChannelsCallingLiveTranslateMessagesTranslateTranscriptDeltaEventParams
    calling.live_translate_translateTranscriptDeltaEvent:
      type: object
      properties:
        jsonrpc:
          $ref: >-
            #/components/schemas/ChannelsCallingLiveTranslateMessagesTranslateTranscriptDeltaEventJsonrpc
          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/ChannelsCallingLiveTranslateMessagesTranslateTranscriptDeltaEventMethod
          description: Always `signalwire.event`.
        params:
          $ref: >-
            #/components/schemas/ChannelsCallingLiveTranslateMessagesTranslateTranscriptDeltaEventParams
          description: The event envelope.
      required:
        - jsonrpc
        - id
        - method
        - params
      description: >-
        Streams an incremental translation delta during a `realtime`-mode
        `calling.live_translate` session.
      title: calling.live_translate_translateTranscriptDeltaEvent
    ChannelsCallingLiveTranslateMessagesTranslateLiveSummaryEventJsonrpc:
      type: string
      enum:
        - '2.0'
      description: JSON-RPC version. Always `2.0`.
      title: ChannelsCallingLiveTranslateMessagesTranslateLiveSummaryEventJsonrpc
    ChannelsCallingLiveTranslateMessagesTranslateLiveSummaryEventMethod:
      type: string
      enum:
        - signalwire.event
      description: Always `signalwire.event`.
      title: ChannelsCallingLiveTranslateMessagesTranslateLiveSummaryEventMethod
    ChannelsCallingLiveTranslateMessagesTranslateLiveSummaryEventParamsEventType:
      type: string
      enum:
        - calling.ai.translate.live_summary
      description: The event type — identifies which event this is.
      title: >-
        ChannelsCallingLiveTranslateMessagesTranslateLiveSummaryEventParamsEventType
    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
    Calling.TranslateLiveSummaryEventData:
      type: object
      properties:
        node_id:
          type: string
          description: >-
            Opaque identifier that, paired with `call_id`, addresses this call.
            Echo back the value you received; treat it as opaque.
        call_id:
          type: string
          description: Unique identifier of the call.
        segment_id:
          type: string
          description: >-
            Identifier of the call segment this event belongs to, for
            correlating events within the same segment of a call.
        tag:
          type: string
          description: >-
            The `tag` you set when placing the call, echoed back so you can
            match the event to your request.
        primary_conversation_summary:
          type: string
          description: >-
            The source-language side: raw transcript text in realtime mode, or
            an AI-generated summary in on-demand `summarize` mode.
        secondary_conversation_summary:
          type: string
          description: >-
            The translated side: raw transcript text in realtime mode, or an
            AI-generated summary in on-demand `summarize` mode.
        primary_conversation_log:
          type: array
          items:
            $ref: '#/components/schemas/Calling.ConversationLogEntry'
          description: >-
            The source-language conversation, one entry per turn. Present only
            in on-demand `summarize` mode.
        secondary_conversation_log:
          type: array
          items:
            $ref: '#/components/schemas/Calling.ConversationLogEntry'
          description: >-
            The translated conversation, one entry per turn. Present only in
            on-demand `summarize` mode.
        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:
        - node_id
        - call_id
        - call_info
        - channel_data
      description: >-
        A summary of a `calling.live_translate` session, covering both the
        source-language (`primary`)

        and translated (`secondary`) sides. This event carries two shapes
        depending on how it was

        produced: in realtime mode (delivered when the session closes) the two
        `*_conversation_summary`

        fields hold the raw transcript text and no logs are included; in
        on-demand `summarize` mode the

        `*_conversation_log` arrays are present and the summaries are
        AI-generated.
      title: Calling.TranslateLiveSummaryEventData
    ChannelsCallingLiveTranslateMessagesTranslateLiveSummaryEventParams:
      type: object
      properties:
        event_type:
          $ref: >-
            #/components/schemas/ChannelsCallingLiveTranslateMessagesTranslateLiveSummaryEventParamsEventType
          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/Calling.TranslateLiveSummaryEventData'
          description: The event-specific payload.
      required:
        - event_type
        - event_channel
        - timestamp
        - params
      description: The event envelope.
      title: ChannelsCallingLiveTranslateMessagesTranslateLiveSummaryEventParams
    calling.live_translate_translateLiveSummaryEvent:
      type: object
      properties:
        jsonrpc:
          $ref: >-
            #/components/schemas/ChannelsCallingLiveTranslateMessagesTranslateLiveSummaryEventJsonrpc
          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/ChannelsCallingLiveTranslateMessagesTranslateLiveSummaryEventMethod
          description: Always `signalwire.event`.
        params:
          $ref: >-
            #/components/schemas/ChannelsCallingLiveTranslateMessagesTranslateLiveSummaryEventParams
          description: The event envelope.
      required:
        - jsonrpc
        - id
        - method
        - params
      description: >-
        A summary of a `calling.live_translate` session, covering both the
        source and translated sides.
      title: calling.live_translate_translateLiveSummaryEvent
    ChannelsCallingLiveTranslateMessagesTranslateConversationLogEventJsonrpc:
      type: string
      enum:
        - '2.0'
      description: JSON-RPC version. Always `2.0`.
      title: ChannelsCallingLiveTranslateMessagesTranslateConversationLogEventJsonrpc
    ChannelsCallingLiveTranslateMessagesTranslateConversationLogEventMethod:
      type: string
      enum:
        - signalwire.event
      description: Always `signalwire.event`.
      title: ChannelsCallingLiveTranslateMessagesTranslateConversationLogEventMethod
    ChannelsCallingLiveTranslateMessagesTranslateConversationLogEventParamsEventType:
      type: string
      enum:
        - calling.ai.translate.conversation_log
      description: The event type — identifies which event this is.
      title: >-
        ChannelsCallingLiveTranslateMessagesTranslateConversationLogEventParamsEventType
    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
    CallingTranslateConversationLogEventDataTranslateData1:
      type: object
      additionalProperties:
        $ref: '#/components/schemas/Calling.TranslateLegData'
      title: CallingTranslateConversationLogEventDataTranslateData1
    CallingTranslateConversationLogEventDataTranslateData:
      oneOf:
        - $ref: '#/components/schemas/Calling.TranslateLegData'
        - $ref: >-
            #/components/schemas/CallingTranslateConversationLogEventDataTranslateData1
        - 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: CallingTranslateConversationLogEventDataTranslateData
    Calling.TranslateConversationLogEventData:
      type: object
      properties:
        node_id:
          type: string
          description: >-
            Opaque identifier that, paired with `call_id`, addresses this call.
            Echo back the value you received; treat it as opaque.
        call_id:
          type: string
          description: Unique identifier of the call.
        segment_id:
          type: string
          description: >-
            Identifier of the call segment this event belongs to, for
            correlating events within the same segment of a call.
        tag:
          type: string
          description: >-
            The `tag` you set when placing the call, echoed back so you can
            match the event to your request.
        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/CallingTranslateConversationLogEventDataTranslateData
          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:
        - node_id
        - call_id
        - primary_conversation_log
        - secondary_conversation_log
        - translate_data
        - call_info
        - channel_data
      description: >-
        The complete conversation log for a `calling.live_translate` session,
        delivered once the session ends, with both the source-language and
        translated sides.
      title: Calling.TranslateConversationLogEventData
    ChannelsCallingLiveTranslateMessagesTranslateConversationLogEventParams:
      type: object
      properties:
        event_type:
          $ref: >-
            #/components/schemas/ChannelsCallingLiveTranslateMessagesTranslateConversationLogEventParamsEventType
          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/Calling.TranslateConversationLogEventData'
          description: The event-specific payload.
      required:
        - event_type
        - event_channel
        - timestamp
        - params
      description: The event envelope.
      title: ChannelsCallingLiveTranslateMessagesTranslateConversationLogEventParams
    calling.live_translate_translateConversationLogEvent:
      type: object
      properties:
        jsonrpc:
          $ref: >-
            #/components/schemas/ChannelsCallingLiveTranslateMessagesTranslateConversationLogEventJsonrpc
          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/ChannelsCallingLiveTranslateMessagesTranslateConversationLogEventMethod
          description: Always `signalwire.event`.
        params:
          $ref: >-
            #/components/schemas/ChannelsCallingLiveTranslateMessagesTranslateConversationLogEventParams
          description: The event envelope.
      required:
        - jsonrpc
        - id
        - method
        - params
      description: >-
        The complete conversation log for a `calling.live_translate` session —
        both the source-language and translated sides — emitted once the session
        ends.
      title: calling.live_translate_translateConversationLogEvent
    ChannelsCallingLiveTranslateMessagesCallingLiveTranslateResponseJsonrpc:
      type: string
      enum:
        - '2.0'
      description: JSON-RPC version. Always `2.0`.
      title: ChannelsCallingLiveTranslateMessagesCallingLiveTranslateResponseJsonrpc
    Calling.LiveTranslateResult:
      type: object
      properties:
        code:
          type: string
          description: >-
            Result code as a string. `"200"` means success. Failures use an
            HTTP-style code

            such as `"400"` (bad request), `"403"`, `"404"` (call not found),
            `"405"`, `"409"`

            (conflict, for example another operation is still running), `"410"`
            (call gone),

            or `"500"`. If the call could not be reached in time, `code` is a
            lowercase error

            identifier instead, such as `response_timeout`, `not_available`, or

            `internal_error`.
        message:
          type: string
          description: >-
            Human-readable description of the result. On failure, it explains
            what went wrong. Always check `code`; `message` may be omitted when
            there is nothing extra to report.
        call_id:
          type: string
          description: The call this result is for, echoed from your request.
      required:
        - code
      description: >-
        Acknowledgement that the action was accepted. `message` is the raw
        status line

        (`"+OK\n"`). If the action is invalid, `code` is `"400"` and `message`
        carries

        the error text.
      title: Calling.LiveTranslateResult
    JsonRpcErrorCode0:
      type: string
      enum:
        - '-32000'
      title: JsonRpcErrorCode0
    JsonRpcErrorCode1:
      type: string
      enum:
        - '-32001'
      title: JsonRpcErrorCode1
    JsonRpcErrorCode2:
      type: string
      enum:
        - '-32002'
      title: JsonRpcErrorCode2
    JsonRpcErrorCode3:
      type: string
      enum:
        - '-32003'
      title: JsonRpcErrorCode3
    JsonRpcErrorCode4:
      type: string
      enum:
        - '-32004'
      title: JsonRpcErrorCode4
    JsonRpcErrorCode5:
      type: string
      enum:
        - '-32005'
      title: JsonRpcErrorCode5
    JsonRpcErrorCode6:
      type: string
      enum:
        - '-32600'
      title: JsonRpcErrorCode6
    JsonRpcErrorCode7:
      type: string
      enum:
        - '-32601'
      title: JsonRpcErrorCode7
    JsonRpcErrorCode8:
      type: string
      enum:
        - '-32602'
      title: JsonRpcErrorCode8
    JsonRpcErrorCode9:
      type: string
      enum:
        - '-32603'
      title: JsonRpcErrorCode9
    JsonRpcErrorCode10:
      type: string
      enum:
        - '-32700'
      title: JsonRpcErrorCode10
    JsonRpcErrorCode:
      oneOf:
        - $ref: '#/components/schemas/JsonRpcErrorCode0'
        - $ref: '#/components/schemas/JsonRpcErrorCode1'
        - $ref: '#/components/schemas/JsonRpcErrorCode2'
        - $ref: '#/components/schemas/JsonRpcErrorCode3'
        - $ref: '#/components/schemas/JsonRpcErrorCode4'
        - $ref: '#/components/schemas/JsonRpcErrorCode5'
        - $ref: '#/components/schemas/JsonRpcErrorCode6'
        - $ref: '#/components/schemas/JsonRpcErrorCode7'
        - $ref: '#/components/schemas/JsonRpcErrorCode8'
        - $ref: '#/components/schemas/JsonRpcErrorCode9'
        - $ref: '#/components/schemas/JsonRpcErrorCode10'
      title: JsonRpcErrorCode
    JsonRpcError:
      type: object
      properties:
        code:
          $ref: '#/components/schemas/JsonRpcErrorCode'
          description: >-
            The error code — a negative integer identifying the failure. See
            `JsonRpcErrorCode` for the full list of values and meanings.
        message:
          type: string
          description: A human-readable description of what went wrong.
        original_request:
          type: object
          additionalProperties:
            description: Any type
          description: >-
            An echo of the request that failed — the full JSON-RPC frame you
            sent

            (`jsonrpc`, `id`, `method`, `params`). Always present.
        requester_nodeid:
          type: string
          description: >-
            The node that sent the failed request. Present only on some routing
            errors.
        requester_identity:
          type: string
          description: >-
            The identity of the requester. Present only on some routing errors;
            same value as `requester_nodeid`.
        responder_nodeid:
          type: string
          description: >-
            The node that was handling the request. Present only on some routing
            errors.
        responder_identity:
          type: string
          description: >-
            The identity of the responder. Present only on some routing errors;
            same value as `responder_nodeid`.
        last_hop_timeout:
          type: boolean
          description: >-
            `true` when the request timed out on its final hop inside
            SignalWire. Present only on some timeout errors.
      required:
        - code
        - message
        - original_request
      description: >-
        A JSON-RPC 2.0 error object, delivered on the `error` field of a
        `JsonRpcResponse` when

        a request fails at the protocol level (bad version, authentication,
        scope, params, or

        your project's connection limit). It replaces `result` — a frame carries
        one or the other, never both.
      title: JsonRpcError
    calling.live_translate_callingLiveTranslateResponse:
      type: object
      properties:
        jsonrpc:
          $ref: >-
            #/components/schemas/ChannelsCallingLiveTranslateMessagesCallingLiveTranslateResponseJsonrpc
          description: JSON-RPC version. Always `2.0`.
        id:
          type: string
          description: The id of the request this responds to.
        result:
          $ref: '#/components/schemas/Calling.LiveTranslateResult'
          description: The method result. Present when the request succeeded.
        error:
          $ref: '#/components/schemas/JsonRpcError'
          description: >-
            Present instead of `result` when the request failed at the protocol
            level.
      required:
        - jsonrpc
        - id
      description: >-
        A JSON-RPC response frame correlated to a request by `id`. On success
        the frame carries

        `result` (the method result). If the request fails at the protocol level
        — an

        incompatible version, failed authentication, insufficient scope, invalid
        params, or your

        project's connection limit — the frame carries `error` instead of
        `result`. Many

        method-level failures (for example most Calling failures) are reported
        the other way: a

        normal `result` whose own `code` is not `"200"`. Each method documents
        which form its

        failures take.


        An `error` returned for `signalwire.connect` is followed by the service
        closing the

        WebSocket; open a new connection to try again. The same happens when

        `signalwire.reauthenticate` sends credentials that are rejected, except
        for a

        Subscriber Access Token. Errors on any other request leave the
        connection open.
      title: calling.live_translate_callingLiveTranslateResponse
    ChannelsCallingLiveTranslateMessagesCallingLiveTranslateRequestJsonrpc:
      type: string
      enum:
        - '2.0'
      description: JSON-RPC version. Always `2.0`.
      title: ChannelsCallingLiveTranslateMessagesCallingLiveTranslateRequestJsonrpc
    ChannelsCallingLiveTranslateMessagesCallingLiveTranslateRequestMethod:
      type: string
      enum:
        - calling.live_translate
      description: The name of the JSON-RPC method being invoked.
      title: ChannelsCallingLiveTranslateMessagesCallingLiveTranslateRequestMethod
    Calling.TranslateDirection:
      type: string
      enum:
        - local-caller
        - remote-caller
      title: Calling.TranslateDirection
    Calling.TranslationFilterPreset:
      type: string
      enum:
        - polite
        - rude
        - professional
        - shakespeare
        - gen-z
      title: Calling.TranslationFilterPreset
    CallingLiveTranslateStartFilterFrom:
      oneOf:
        - $ref: '#/components/schemas/Calling.TranslationFilterPreset'
        - type: string
      description: >-
        Adjusts the tone or style applied when translating the source speaker —
        a

        preset, or a `prompt:`-prefixed custom instruction.
      title: CallingLiveTranslateStartFilterFrom
    CallingLiveTranslateStartFilterTo:
      oneOf:
        - $ref: '#/components/schemas/Calling.TranslationFilterPreset'
        - type: string
      description: >-
        Adjusts the tone or style applied when translating toward the target
        speaker

        — a preset, or a `prompt:`-prefixed custom instruction.
      title: CallingLiveTranslateStartFilterTo
    Calling.LiveSpeechEngine:
      type: string
      enum:
        - deepgram
        - google
      title: Calling.LiveSpeechEngine
    Calling.LiveTranslateMode:
      type: string
      enum:
        - classic
        - realtime
      title: Calling.LiveTranslateMode
    Calling.LiveTranslateStart:
      type: object
      properties:
        from_lang:
          type: string
          description: The language being spoken, e.g. `en-US`.
        to_lang:
          type: string
          description: The language to translate into, e.g. `es-ES`.
        direction:
          type: array
          items:
            $ref: '#/components/schemas/Calling.TranslateDirection'
          description: Which side(s) of the call to translate.
        webhook:
          type: string
          format: uri
          description: >-
            An `http` or `https` URL that receives the translation results as
            they are produced. When unset, results are delivered over the Relay
            connection.
        from_voice:
          type: string
          description: The voice used to speak the source language. Defaults to `josh`.
        to_voice:
          type: string
          description: The voice used to speak the translated language. Defaults to `josh`.
        filter_from:
          $ref: '#/components/schemas/CallingLiveTranslateStartFilterFrom'
          description: >-
            Adjusts the tone or style applied when translating the source
            speaker — a

            preset, or a `prompt:`-prefixed custom instruction.
        filter_to:
          $ref: '#/components/schemas/CallingLiveTranslateStartFilterTo'
          description: >-
            Adjusts the tone or style applied when translating toward the target
            speaker

            — a preset, or a `prompt:`-prefixed custom instruction.
        live_events:
          type: boolean
          description: >-
            Deliver translation results live as the conversation happens, rather
            than only at the end.
        ai_summary:
          type: boolean
          description: >-
            Generate an AI summary of the conversation. The summary is delivered
            when the call ends.
        ai_summary_prompt:
          type: string
          description: >-
            Instructions telling the AI how to summarize, used when `ai_summary`
            is enabled.
        speech_timeout:
          type: integer
          minimum: 0
          default: 60000
          description: Speech-recognition timeout in milliseconds. Default `60000`.
        vad_silence_ms:
          type: integer
          minimum: 0
          description: >-
            Voice-activity-detection silence time in milliseconds. The default
            is

            engine-dependent (Deepgram vs Google) and is not fixed by this
            method.
        vad_thresh:
          type: integer
          minimum: 0
          maximum: 1800
          default: 400
          description: >-
            Voice-activity-detection energy threshold (0–1800; default `400`).
            It sets the audio-energy floor for detecting speech: higher values
            are less sensitive (they require louder input); lower values are
            more sensitive.
        speech_engine:
          $ref: '#/components/schemas/Calling.LiveSpeechEngine'
          default: deepgram
          description: Speech engine to use. Default `deepgram`.
        mode:
          $ref: '#/components/schemas/Calling.LiveTranslateMode'
          default: classic
          description: >-
            Translation mode. `classic` (default) translates in discrete turns;

            `realtime` translates continuously. In `realtime` mode several
            `classic`-only

            parameters are ignored.
        translation_model:
          type: string
          default: gpt-4.1-nano
          description: >-
            The model that translates each utterance. An unsupported value falls
            back to the

            default `gpt-4.1-nano`. Ignored in `realtime` mode.
        translation_model_params:
          type: object
          additionalProperties:
            description: Any type
          description: >-
            Request parameters for the translation model, such as `temperature`
            or `top_p`,

            applied over the defaults. Keys the model does not support are
            dropped.
        from_voice_params:
          type: object
          additionalProperties:
            description: Any type
          description: |-
            Engine-specific tuning for `from_voice`, such as
            `{"eleven_labs_stability": 0.4}`.
        to_voice_params:
          type: object
          additionalProperties:
            description: Any type
          description: |-
            Engine-specific tuning for `to_voice`, such as
            `{"eleven_labs_stability": 0.4}`.
      required:
        - from_lang
        - to_lang
        - direction
      description: >-
        Settings for starting live translation. `from_lang`, `to_lang` and
        `direction` are required.
      title: Calling.LiveTranslateStart
    Calling.LiveActionStop:
      type: object
      properties: {}
      description: A stop action takes no fields — pass an empty object.
      title: Calling.LiveActionStop
    Calling.LiveSummarize:
      type: object
      properties:
        webhook:
          type: string
          format: uri
          description: An `http` or `https` URL to receive the summary.
        prompt:
          type: string
          description: Instructions telling the AI how to summarize the conversation.
      description: >-
        Settings for generating a summary of the live transcription or
        translation so far.
      title: Calling.LiveSummarize
    Calling.LiveTranslateInject:
      type: object
      properties:
        message:
          type: string
          description: The text to translate and speak into the call.
        direction:
          $ref: '#/components/schemas/Calling.TranslateDirection'
          description: Which side of the call to speak the message to.
      required:
        - message
        - direction
      description: >-
        A message to insert into a live translation. It is translated and spoken
        into the call.
      title: Calling.LiveTranslateInject
    Calling.LiveTranslateAction:
      type: object
      properties:
        start:
          $ref: '#/components/schemas/Calling.LiveTranslateStart'
          description: Start live translation.
        stop:
          $ref: '#/components/schemas/Calling.LiveActionStop'
          description: Stop live translation.
        summarize:
          $ref: '#/components/schemas/Calling.LiveSummarize'
          description: Summarize the live translation so far.
        inject:
          $ref: '#/components/schemas/Calling.LiveTranslateInject'
          description: Insert a message to be translated and spoken into the call.
      description: >-
        The live-translate action to perform. Set exactly one of `start`,
        `stop`,

        `summarize`, or `inject`.
      title: Calling.LiveTranslateAction
    CallingLiveTranslateParamsAction1:
      type: string
      enum:
        - stop
      title: CallingLiveTranslateParamsAction1
    CallingLiveTranslateParamsAction2:
      type: string
      enum:
        - summarize
      title: CallingLiveTranslateParamsAction2
    CallingLiveTranslateParamsAction:
      oneOf:
        - $ref: '#/components/schemas/Calling.LiveTranslateAction'
        - $ref: '#/components/schemas/CallingLiveTranslateParamsAction1'
        - $ref: '#/components/schemas/CallingLiveTranslateParamsAction2'
      description: >-
        The action to perform. Pass the object form and set exactly one of
        `start`,

        `stop`, `summarize`, or `inject`. As a shorthand you may instead pass
        the

        bare string `"stop"` or `"summarize"` (the object form is required to
        `start`

        or `inject`).
      title: CallingLiveTranslateParamsAction
    Calling.LiveTranslateParams:
      type: object
      properties:
        node_id:
          type: string
          description: >-
            Opaque identifier that, paired with `call_id`, addresses this call.
            Echo back the value you received; treat it as opaque.
        call_id:
          type: string
          description: Unique identifier of the call.
        action:
          $ref: '#/components/schemas/CallingLiveTranslateParamsAction'
          description: >-
            The action to perform. Pass the object form and set exactly one of
            `start`,

            `stop`, `summarize`, or `inject`. As a shorthand you may instead
            pass the

            bare string `"stop"` or `"summarize"` (the object form is required
            to `start`

            or `inject`).
        status_url:
          type: string
          format: uri
          description: >-
            Reserved and currently unused — live translation results are
            delivered to `webhook` (or over the Relay connection when no
            `webhook` is set).
      required:
        - node_id
        - call_id
        - action
      title: Calling.LiveTranslateParams
    calling.live_translate_callingLiveTranslateRequest:
      type: object
      properties:
        jsonrpc:
          $ref: >-
            #/components/schemas/ChannelsCallingLiveTranslateMessagesCallingLiveTranslateRequestJsonrpc
          description: JSON-RPC version. Always `2.0`.
        id:
          type: string
          description: Request id, echoed on the correlated response.
        method:
          $ref: >-
            #/components/schemas/ChannelsCallingLiveTranslateMessagesCallingLiveTranslateRequestMethod
          description: The name of the JSON-RPC method being invoked.
        params:
          $ref: '#/components/schemas/Calling.LiveTranslateParams'
          description: The method's input parameters.
      required:
        - jsonrpc
        - id
        - method
        - params
      description: >-
        A JSON-RPC request frame. `Method` is the method name; `Params` is the
        method's input.
      title: calling.live_translate_callingLiveTranslateRequest

```