Complete a consultative transfer ('devri tamamla')
POST/api/calls/:callId/transfer/complete
CONSULTATIVE transfer only (SES-1 F4). The two agents have talked; the offering agent now hands the call over for real.
Order is the feature and it is the opposite of the offer's: the MEDIA
moves first. The bridge promotes the consultation's leg to the primary
one atomically (21-KOPRU-SOZLESMESI §12.6 — make-before-break, the
colleague has been carrying audio for the whole consultation, so
"connected" is already proven), and only if that succeeded does
answered_by move here. A row saying "handed over" while the bridge
still had the old agent on the wire would leave two panels disagreeing
about whose call it is.
The customer STAYS PARKED across the swap — which is also why it cannot produce an instant of silence: they are on music on both sides of it. They come back when the NEW agent presses resume.
Only the agent HOLDING the call may press it, and only while the bridge
says the consultation is connected.
Request
Responses
- 200
- 401
- 403
- 404
- 409
- 501
The call is the colleague's; the customer is still on hold.
Not authenticated. code: account_disabled means the member's seat was deactivated in this workspace: the session is over even though the token was not revoked (clients sign out and clean up).
call_held_by_other — only the agent holding the call may complete it.
Resource not found (or not visible to the current tenant).
consult_not_pending (no consultation on this call), consult_not_connected (the colleague's leg has not come up — the server refuses to hand the customer to a microphone that may never exist) or consult_promote_failed (the bridge refused: usually leg_superseded, a device takeover that won during the consultation). Nothing is written in any of them.
consult_unsupported — this bridge carries one agent leg.