Rejoin a Call

Get new credentials after the team member's connection dropped.

Gives new credentials after the team member's connection dropped, for example after a network change or a page reload. Call it within 60 seconds of the drop; until then the customer stays on the line.

Endpoint

POST https://public.doubletick.io/v1/call/person/{callId}/reconnect

Authentication

Include your API key in the Authorization header.

HeaderValue
Authorization<your-api-key>
Content-Typeapplication/json

📘

NOTE

If you do not have your DoubleTick API Key, you can obtain it by following this guide link.


Request Body

FieldRequiredNotes
agentNumberyesThe team member, by the phone number on their DoubleTick profile.

Example Request

curl -X POST https://public.doubletick.io/v1/call/person/{callId}/reconnect \
  -H 'Authorization: <your-api-key>' \
  -H 'Content-Type: application/json' \
  -d '{ "agentNumber": "<team member number>" }'

Example Response

{
  "success": true,
  "message": "Call reconnected",
  "data": { ...the call... },
  "credentials": { ...new join details... }
}

Things to Know

  • Only the team member on the call can rejoin it.
  • One join at a time: a new join replaces the team member's current connection on the call (see Joining a VOIP call in the Overview).

Error Responses

Besides the errors on every route (see Errors in the Overview):

StatusreasonMessageWhen
404NOT_FOUNDCall not foundNo such team-member call in your organization.
401UNAUTHORIZEDYour organization does not have a calling license or add-on. Please contact [email protected]A WhatsApp call, and WhatsApp calling is not on your plan.
400ANSWERED_ON_PHONEThis call is on the agent's phone: answer, decline or rejoin it there.A PSTN call.
400CALLING_NOT_SUPPORTEDCalling is not supported on this number.The call's number no longer supports API calling.
422 · 409—Call cannot be reconnected by a different user · Call is not in progress · Only the agent on the call can rejoin it · Call is already connected to a different deviceSomeone else's call, a call that is over, or a call held on another device.

Rate Limit

60 a minute per organization and team member.


What’s Next

Join with the new credentials. When the conversation is over, hang up.

Did this page help you?