API documentation

DELETE /contacts/:id/calls

Authorization Required

https://[your-subdomain].trackdrive.com/api/v1/contacts/:id/calls

Hang up a contact's ongoing calls

Ends any calls from this contact that are currently in progress, queuing the hangup right away - it does not delete call history or any records. Use it to stop a live call immediately, for example right after blocking a caller. Requires superuser access.

Params

Param name	Description
uuid Optional	A unique identifier eg: 5cc8897c-ad0f-44cb-8ea7-8f7736ae76f1 Must be a String

Param name

Description

uuid
Optional

A unique identifier eg: 5cc8897c-ad0f-44cb-8ea7-8f7736ae76f1

Must be a String

Example Request

curl -X DELETE 'https://[your-subdomain].trackdrive.com/api/v1/contacts/+12125559001/calls' \
  -H 'Authorization: Basic BASE64_ENCODED_PUBLIC_KEY_AND_PRIVATE_KEY'

Example Response 200

{
  "status": 200,
  "success": true,
  "errors": {},
  "contact": {
    "id": 10001,
    "type": "Contact",
    "uuid": "a6af7847-1b1e-4760-ac0d-e1813a6d3a09",
    "created_at": "2026-01-15T15:30:00.000Z",
    "updated_at": "2026-01-15T15:30:00.000Z",
    "deleted_at": null,
    "user_updated_at": null,
    "routes_show_path": "/contacts/10001",
    "routes_edit_path": "/contacts/10001/edit",
    "external_record_id": null,
    "number": "+12125559001",
    "last_call_at": null,
    "blocked": false,
    "opt_out": null,
    "calls_count": 0,
    "outbound_call_failure_count": 0,
    "outbound_no_answer_count": 0,
    "blocked_at": null,
    "sms_opt_out_at": null
  },
  "metadata": {
    "root": "contact"
  }
}