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

GET /

Receive AI errors on a call

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

## AsyncAPI Specification

```yaml
asyncapi: 2.6.0
info:
  title: calling.error
  version: subpackage_callingError.calling.error
  description: Receive AI errors on a call
channels:
  /:
    description: Receive AI errors on a call
    publish:
      operationId: subpackage_callingError.calling.error-publish
      summary: calling.error
      message:
        name: onCallingErrorCallErrorEvent
        title: calling.error
        payload:
          $ref: '#/components/schemas/calling.error_callErrorEvent'
servers:
  production:
    url: wss://relay.signalwire.com/
    protocol: wss
    x-default: true
components:
  schemas:
    ChannelsCallingErrorMessagesCallErrorEventJsonrpc:
      type: string
      enum:
        - '2.0'
      description: JSON-RPC version. Always `2.0`.
      title: ChannelsCallingErrorMessagesCallErrorEventJsonrpc
    ChannelsCallingErrorMessagesCallErrorEventMethod:
      type: string
      enum:
        - signalwire.event
      description: Always `signalwire.event`.
      title: ChannelsCallingErrorMessagesCallErrorEventMethod
    ChannelsCallingErrorMessagesCallErrorEventParamsEventType:
      type: string
      enum:
        - calling.error
      description: The event type — identifies which event this is.
      title: ChannelsCallingErrorMessagesCallErrorEventParamsEventType
    ChannelsCallingErrorMessagesCallErrorEventParamsParamsError:
      oneOf:
        - type: string
        - type: object
          additionalProperties:
            description: Any type
      description: >-
        What went wrong. Usually a human-readable string; some sources place a
        structured

        object here instead, such as the error body returned by an AI provider.
        Absent on

        error types that describe the failure with other fields.
      title: ChannelsCallingErrorMessagesCallErrorEventParamsParamsError
    ChannelsCallingErrorMessagesCallErrorEventParamsParams:
      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.
        error:
          $ref: >-
            #/components/schemas/ChannelsCallingErrorMessagesCallErrorEventParamsParamsError
          description: >-
            What went wrong. Usually a human-readable string; some sources place
            a structured

            object here instead, such as the error body returned by an AI
            provider. Absent on

            error types that describe the failure with other fields.
        error_type:
          type: string
          description: >-
            A short category for the error, when the source sets one — for
            example `webhook_fail` or `event_webhook_fail`.
        error_reason:
          type: string
          description: A machine-readable reason for the error, when the source sets one.
        fatal:
          type: boolean
          description: >-
            Whether the error was fatal to the operation in progress — for
            example, one that ended the AI session. Absent when not reported.
      required:
        - node_id
        - call_id
      description: The event-specific payload.
      title: ChannelsCallingErrorMessagesCallErrorEventParamsParams
    ChannelsCallingErrorMessagesCallErrorEventParams:
      type: object
      properties:
        event_type:
          $ref: >-
            #/components/schemas/ChannelsCallingErrorMessagesCallErrorEventParamsEventType
          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/ChannelsCallingErrorMessagesCallErrorEventParamsParams
          description: The event-specific payload.
      required:
        - event_type
        - event_channel
        - timestamp
        - params
      description: The event envelope.
      title: ChannelsCallingErrorMessagesCallErrorEventParams
    calling.error_callErrorEvent:
      type: object
      properties:
        jsonrpc:
          $ref: >-
            #/components/schemas/ChannelsCallingErrorMessagesCallErrorEventJsonrpc
          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/ChannelsCallingErrorMessagesCallErrorEventMethod
          description: Always `signalwire.event`.
        params:
          $ref: >-
            #/components/schemas/ChannelsCallingErrorMessagesCallErrorEventParams
          description: The event envelope.
      required:
        - jsonrpc
        - id
        - method
        - params
      description: >-
        Fires when an error occurs in the AI features running on a call
        (`calling.ai`,

        `calling.amazon_bedrock`, or live transcription/translation). It reports
        problems such

        as a failed SWAIG webhook, a missing or invalid SWAIG function, a model
        or voice

        fallback, or a speech-processing failure. The payload always identifies
        the call;

        the other fields vary by the error source.


        A failed call command (for example a `calling.play` or `calling.connect`
        that returns a

        non-`"200"` `code`) is not reported on your connection through this
        event; check the

        command's result instead.
      title: calling.error_callErrorEvent

```