Skip to main content
DELETE
Delete call attempt
DELETE /interviews/{id}/call-attempts/{attemptId} is a permanent alias of this endpoint and keeps working unchanged, with the same scopes and the same response. See Resource names.
Cancels and permanently deletes a specific call attempt.
ONLINE conversations: managing individual call attempts is forbidden on an ONLINE conversation.

Overview

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

Constraints

  • In-progress protection: as with rescheduling, deleting an attempt that is IN_PROGRESS is blocked.
  • The conversation survives: deleting attempts does not delete the conversation. To remove the conversation and all its data, use Delete Conversation.
Use case: clearing failed or redundant attempts out of a conversation’s history, or cancelling a pending retry that is no longer wanted.

Webhooks

This endpoint emits no webhook. It cancels a single call attempt without changing the conversation’s own status, so no conversation-level lifecycle event applies — in particular, no conversation.cancelled is sent.
Deleting the last remaining scheduled attempt leaves the conversation SCHEDULED with no future call queued, and emits no event. If your system treats a conversation as open until a terminal event arrives, either follow this call with Delete Conversation, or schedule a replacement 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