WAwavix
Call control

Answer a call

Changed on

Answers the inbound call identified by id. Optionally starts recording, post-call transcription, or live media streaming on answer.

post/v1/calls/{id}/answer

Request

  • Base URL
    https://api.wavix.com
  • URL
    https://api.wavix.com/v1/calls/{id}/answer
  • Auth
    HTTP bearer

Path parameters

idstring uuid required

The uuid of the call.

Request body

call_recordingboolean

Indicates whether the call should be recorded.

call_transcriptionboolean

Indicates whether the call should be transcribed after it ends.

stream_urlstring uri

WebSocket URL (ws:// or wss://) that receives the call's audio, which can include the caller's voice.

stream_type'oneway' | 'twoway'

Specifies the streaming type. Can be either oneway for unidirectional or twoway for bidirectional streaming.

stream_channel'inbound' | 'outbound' | 'both'

Audio channel to stream: inbound streams the incoming channel (to Wavix), outbound the outbound channel (from Wavix), and both both channels. For bidirectional call streaming, this setting is ignored and only the inbound channel is streamed.

Example request

{
  "stream_url": "wss://examples.com/stream"
}

Response

Returns a success confirmation. The call is answered.

successboolean required

Indicates whether the request was successful.

Example response

{
  "success": true
}

Changes

  • d4db3aae3627Revision changes
    • breaking

      request property was restricted to a list of enum values

    • breaking

      request property was restricted to a list of enum values

    • breaking

      the request property type changed from no type to string

    • breaking

      the request property type changed from no type to string

    • warning

      removed from the request property allOf list

    • warning

      removed from the request property allOf list

    • info

      added the new both enum value to the request property

    • info

      added the new inbound enum value to the request property

    • info

      added the new oneway enum value to the request property

    • info

      added the new outbound enum value to the request property

    • info

      added the new twoway enum value to the request property

  • 6a89c962481cRevision changes
    • info

      added the non-success response with the status