Delete interview
Interviews
Delete Interview
Permanently deletes an interview and all associated data (transcripts, recordings, and analyses). This action is irreversible. Scheduled interviews are automatically removed from the processing queue. For in-progress interviews, the active call continues until completion, but all post-call processing is skipped and concurrency slots are released.
DELETE
Delete interview
Permanently deletes an interview and its associated data. This action cannot be undone.
Overview
The delete interview endpoint permanently removes an interview and all its data (transcripts, recordings, analyses) from your account. This is useful for data hygiene or removing unwanted tests.Use Cases
- Remove Canceled Interviews: Clean up interviews that were scheduled but no longer needed
- Clean Up Test Interviews: Remove test or development interviews from production
- Data Management: Permanently remove interviews and all associated data
Impact on Associated Data
Interview States
Interviews can be deleted regardless of their current status:Scheduled Interview Behavior
When you delete a scheduled interview, it is automatically removed from
the processing queue. The call will not be initiated. Any scheduled call
attempts are marked as CANCELLED and removed from the queue.
In-Progress Interview Behavior
When you delete an in-progress interview:- The active phone call continues until it ends naturally
- When the call ends, no post-call processing occurs:
- No transcript generation
- No analysis or scoring
- No completion webhooks
- Concurrency slots are released when the call ends
Webhooks
Deletion emits no webhook, including nointerview.cancelled. Deleting removes the resource outright rather than cancelling it, and any of the interview’s webhook deliveries still pending at that moment are cancelled as part of the same operation.
Example Usage
Company Isolation
You can only delete interviews that belong to your API key’s company. Attempting to delete an interview from another company will result in a403 Forbidden error.
Required Scopes
This endpoint requires thedelete:interviews scope. Ensure your API key has this scope enabled.
Error Scenarios
Related Resources
Interviews Resource Guide
Learn about interview management and lifecycle
List Interviews
View all active interviews
Get Interview
Retrieve interview details before deletion
Create Interview
Schedule new interviews
Authorizations
API key for authentication using Bearer scheme
Path Parameters
Query Parameters
Required for ATS API keys to specify which company to access. Ignored for standard company API keys.