Cancel Scheduled Call

​

Endpoint

​

Authentication

​

Path parameters

• appId (UUID, required)
• id (UUID, required) — the scheduled call id

​

Request body

{ "reason": "Customer no longer interested" }

​

Behavior

• The row is never hard-deleted; only status transitions to cancelled.
• Pending reminders for the call are cancelled.
• A cancelled event is appended to the timeline, and any configured webhook subscription receives scheduled.cancelled.
• Idempotent — calling DELETE on an already-cancelled row returns the row unchanged.

​

Response

{
  "data": {
    "call": {
      "id": "uuid",
      "status": "cancelled",
      "cancelled_at": "2026-04-22T12:00:00.000Z",
      "cancellation_reason": "Customer no longer interested"
    }
  }
}

​

Errors

• 403 forbidden unauthorized for app or missing scope
• 404 not_found call does not belong to this app
• 500 server_error

​

Example

curl -X DELETE "https://api.apifycloud.io/api/v1/video/{appId}/scheduled-calls/{id}" \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json" \
  -d '{ "reason": "Customer no longer interested" }'