Calls

Discard a dialpad call record

POST
/api/calls/{callId}/discard

Deletes the Call document and, if its linked voice Conversation has no messages, deletes that conversation too. If deleteContact: true is supplied with contactId, also deletes a newly-created placeholder contact (firstName: "New Contact", source: "Outgoing Call") and emits contact_removed. Safe no-op if the call was already deleted. Used when a user dials a wrong number from the dialpad.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

callId*string

The provider-agnostic callId minted by Tether (also used as providerCallId for SDK calls).

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/api/calls/string/discard" \  -H "Content-Type: application/json" \  -d '{    "contactId": "64f0a1b2c3d4e5f6a7b8c9d0",    "deleteContact": true  }'
{  "success": true,  "message": "Configuration saved"}