Call Control
Resume a call
Resumes a call previously placed on hold, restoring two-way audio and returning the call to an active state. Use this endpoint to continue conversations after a hold. For example, following a transfer, a consultation, or multitasking.
Provider Support
Most providers that support hold also support resume. Note: 3CX does not support resume operations and will return an HTTP 404 when invoked.
Behavior
When resumed, the call exits the "hold" state and becomes active again. Hold music (if any) stops, and participants can communicate normally. Call timers and billing continue uninterrupted from the original start time.
Requirements and Errors
Requires:
- A valid call_id referencing a call currently in "hold" state
- A provider that supports resume functionality
Errors may occur if:
- The provider (e.g., 3CX) does not support resume
- The call is not in a "hold" state
- The call connection was lost during the hold period
- The call_id is invalid or not found
- Permissions are insufficient to control the call
Tip: Use the Hold Call endpoint to place a call on hold, and the List Active Calls endpoint to confirm a call's current state before resuming.
curl --request PUT \
--url http://api.voistrix.com/v1/accounts/:accountID/applications/:applicationID/providers/:providerID/calls/:callID/resume \
--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.