Skip to main content
POST
cURL
Cancels a single scheduled call. Any call that has not reached a terminal status (COMPLETED, FAILED, WILL_NOT_DO, SKIPPED_COMPLIANCE, SKIPPED_MANUAL, CANCELLED) is set to CANCELLED. Returns the scheduled call with its updated status.

Repeat requests

The operation is idempotent. If the call is already in a terminal status — including CANCELLED — the request succeeds with HTTP 200 and returns the call with its current status unchanged. There is no 409 conflict response; check the status field in the response to confirm the outcome.

Calls already dispatched

Cancelling a call in PENDING or TASK_CREATED reliably prevents it from being dialed. A call in PROCESSING (actively dialing or in progress) is marked CANCELLED, but this does not disconnect a phone call that is already underway.

Invalid Identifier

An invalid scheduled call UUID returns HTTP 422 Unprocessable Content with a string detail. A valid UUID with no matching record or no verifiable customer relationship returns 404; access to another company’s record returns 403.

Parent schedule is not affected

Cancelling an individual scheduled call does not stop the cadence that created it; later schedule activity can still produce new scheduled calls. To stop outreach entirely, use Close Origination for enrolled origination applications, or Cancel Loan Servicing / Cancel All Communications for collections and outreach.

Authorizations

X-API-Key
string
header
required

Path Parameters

id
string
required

ID of scheduled call to cancel

Response

Scheduled call canceled

Scheduled call response model matching OpenAPI spec.

id
string
required

Identification number of the scheduled call

customerId
string
required

ID of the customer

scheduledTime
string
required

Scheduled time of the call

status
string
required

Status of the scheduled call

callId
string | null

Finosu call UUID, or null before a call is associated with this schedule.

postProcessingFlags
null

Currently always null. This endpoint exposes scheduling state, not call outcome flags. Use the configured call webhook flags field for delivered outcomes.