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.
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 of204
with no content returned in the response body.Errors
A common set of Error Responses can be found here.