Calls
Discard a dialpad call record
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 In: header
Path Parameters
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"}