Skip to main content
DELETE
/
interviews
/
{id}
Delete interview
curl --request DELETE \
  --url https://api.instaview.sk/interviews/{id} \
  --header 'Authorization: Bearer <token>'
true
Deletes an interview by ID. Deleted interviews are removed from list and get operations.

​
Overview

The delete interview endpoint removes an interview from API queries and lists. This helps maintain data hygiene by cleaning up your interview list.

​
Use Cases

  • Remove Canceled Interviews: Clean up interviews that were scheduled but no longer needed
  • Clean Up Completed Interviews: Remove old interviews from active lists
  • Organization: Maintain a clean interview list by removing irrelevant entries

​
Impact on Associated Data

Deleting an interview removes it from API queries. The interview will no longer appear in list queries or be retrievable via the get endpoint.

​
Interview States

Interviews can be deleted regardless of their current status:
StatusDeletableNotes
SCHEDULED✅ YesInterview is removed from queue automatically
IN_PROGRESS✅ YesCall continues, but post-call processing is skipped
COMPLETED✅ YesInterview finished, analysis available
FAILED✅ YesInterview failed to complete
CANCELED✅ YesAlready canceled

​
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

Deleting an in-progress interview allows the active call to continue naturally until completion. However, all post-call processing will be skipped when the call ends.
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
If you need the interview data (transcripts, analysis), wait until the interview completes before deleting it. Deleting an in-progress interview prevents any data collection for that call.

​
Example Usage

async function deleteInterview(interviewId) {
  const response = await fetch(
    `https://api.instaview.sk/interviews/${interviewId}`,
    {
      method: "DELETE",
      headers: {
        Authorization: `Bearer ${apiKey}`,
        "Content-Type": "application/json",
      },
    }
  );

  if (!response.ok) {
    const error = await response.json();
    throw new Error(error.message);
  }

  const { data } = await response.json();
  return data; // Returns true on success
}

// Usage
const deleted = await deleteInterview("550e8400-e29b-41d4-a716-446655440000");
console.log("Interview deleted:", deleted);

​
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 a 403 Forbidden error.

​
Required Scopes

This endpoint requires the delete:interviews scope. Ensure your API key has this scope enabled.

​
Error Scenarios

Status CodeErrorDescription
404Not FoundInterview doesn’t exist or has already been deleted
403ForbiddenInterview belongs to a different company
401UnauthorizedInvalid or missing API key
400Bad RequestInvalid interview ID format

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

​
Authorization
string
header
required

API key for authentication using Bearer scheme

Path Parameters

​
id
string<uuid>
required

Response

200 - application/json

Interview deleted successfully

The response is of type boolean.