---
title: "DELETE /api/scheduled-calls/{scheduled_id}"
method: DELETE
path: "/api/scheduled-calls/{scheduled_id}"
---

# DELETE /api/scheduled-calls/{scheduled_id}

`DELETE /api/scheduled-calls/{scheduled_id}`

## Request

- Base URL: `https://call4.me`
- URL: `https://call4.me/api/scheduled-calls/{scheduled_id}`
- Auth: HTTP bearer

Cancel a scheduled call before it dials.

## Path parameters

- `scheduled_id` string, required

## Response `200`

The canceled schedule

- object
  - `id` string, required
  - `status` 'pending' | 'dialing' | 'placed' | 'failed' | 'canceled', required
  - `business` string, required
  - `number` string, required
  - `call_at` string, required
  - `call_id` string, nullable, required: the call it became, once dialed

## Other responses

- `400`: Request failed
- `401`: Request failed
- `404`: Request failed

---

[API](https://skmtc.dev/call4/apis/call4me-api.md) · [All operations](https://skmtc.dev/call4/apis/call4me-api/llms.txt) · [OpenAPI document](https://skmtc.dev/call4/apis/call4me-api/revisions/f4fa1a5c5f9b?raw)