Call Control

Answer a call

Answers an incoming call that is currently ringing. Use this endpoint to programmatically accept a call on behalf of a subscriber or extension. This is commonly used in automated systems like IVRs, call routing, or contact center agents.

Behavior

The call must be in a "ringing" or "incoming" state. Once accepted, the system connects the caller and callee, and the call transitions to an active state. From that point, call duration and billing (if applicable) begin.

Requirements and Errors

Requires a valid call_id referencing a live, unanswered call. The caller must have permission to control calls for the specified provider.

Errors may occur if:

  • The call_id is invalid or not found.
  • The call is not in an answerable state (e.g., already answered or ended).
  • The system encounters provider connection issues.
  • The caller lacks required permissions.
PUT/v1/accounts/:accountID/applications/:applicationID/providers/:providerID/calls/:callID/answer
Click to copy
curl --request PUT \
  --url http://api.voistrix.com/v1/accounts/:accountID/applications/:applicationID/providers/:providerID/calls/:callID/answer \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Path Parameters

  • :accountID - REQUIRED[String]

    The referenced account ID.

  • :applicationID - REQUIRED[String]

    The referenced application ID.

  • :providerID - REQUIRED[String]

    The referenced provider ID.

  • :callID - REQUIRED[String]

    The referenced call ID.

Response

Indicates the request was successful. Returns a status code of 204 with no content returned in the response body.

Errors

A common set of Error Responses can be found here.