API documentation

DELETE /call_dispositions/:id

Authorization Required

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

Destroy Call Disposition by id.

Permanently deletes a Call Disposition. Restricted to account superusers; built-in system dispositions cannot be deleted.

Example Request

curl -X DELETE 'https://[your-subdomain].trackdrive.com/api/v1/call_dispositions/10001' \
  -H 'Authorization: Basic BASE64_ENCODED_PUBLIC_KEY_AND_PRIVATE_KEY'

Example Response 200

{
  "status": 200,
  "success": true,
  "errors": {},
  "call_disposition": {
    "id": 10001,
    "type": "CallDisposition",
    "uuid": "a6af7847-1b1e-4760-ac0d-e1813a6d3a09",
    "created_at": "2026-01-15T14:30:00.000Z",
    "updated_at": "2026-01-15T15:30:00.000Z",
    "deleted_at": "2026-01-15T15:30:00.000Z",
    "user_updated_at": null,
    "routes_show_path": "/call_dispositions/10001",
    "routes_edit_path": "/call_dispositions/10001/edit",
    "external_record_id": null,
    "sortable_order": 14,
    "key": "example_disposition_3",
    "name": "Example Disposition",
    "hint": null,
    "show_on_agent_widget": null,
    "show_in_tables": null,
    "show_in_reports": null,
    "apply_call_answered": null,
    "apply_agent_handled": null,
    "apply_buyer_handled": null,
    "apply_qualified": null,
    "schedule_callback_now": null,
    "apply_end_of_schedule": null,
    "apply_block_caller": null,
    "apply_auto_next_lead": null,
    "notes_required": null,
    "font_size": 12,
    "text_shadow_color": null,
    "text_color": "#333333",
    "background_color": "#f2f2f2",
    "line_height": 15,
    "context_menu_name": "Example Disposition",
    "call_action_leave_voicemail": null,
    "call_action_apply_opt_out": null,
    "system_status": false,
    "use_when_blank": null,
    "apply_machine_detected": false,
    "schedule_id": null,
    "call_disposition_action_ids": [],
    "reuse_conference": null,
    "apply_add_to_schedule_suppression": null,
    "delete_scheduled_callbacks": null,
    "scheduled_callback_chance": 66,
    "record_token_additional_id": null,
    "record_token_additional_data_count": 0,
    "record_token_additional_data": [],
    "record_token_filter_id": null,
    "record_token_filter_data_count": 0,
    "record_token_filter_data": []
  },
  "metadata": {
    "root": "call_disposition"
  }
}