Skip to main content
DELETE
Delete call attempt
Cancels and permanently deletes a specific call attempt.
ONLINE Interviews: Individual call attempt management is strictly forbidden for ONLINE interviews.

Overview

Deleting a call attempt removes it from the interview’s history and cancels it if it was scheduled for the future.

Constraints

  • In-Progress Protection: Like rescheduling, deleting a call attempt that is currently IN_PROGRESS is blocked.
  • Interview Completion: Deleting call attempts does not delete the interview itself. If you wish to delete the entire interview and all its data, use the Delete Interview endpoint instead.
Use Case: This endpoint is typically used to clean up failed or redundant attempts from the interview history or to cancel a pending retry that is no longer needed.

Webhooks

This endpoint emits no webhook. It cancels a single call attempt without changing the interview’s own status, so no interview-level lifecycle event applies — in particular, no interview.cancelled is sent.
Deleting the last remaining scheduled attempt leaves the interview in SCHEDULED status with no future call queued, and no event is emitted. If your system tracks interviews as open until a terminal event arrives, either follow this call with Delete Interview, or schedule a replacement attempt with Invoke New Call Attempt.

Authorizations

Authorization
string
header
required

API key for authentication using Bearer scheme

Path Parameters

id
string<uuid>
required
attemptId
string<uuid>
required

Query Parameters

companyId
string

Required for ATS API keys to specify which company to access. Ignored for standard company API keys.

Response

204

Call attempt deleted successfully