Skip to main content
DELETE
/
candidates
/
{id}
Delete candidate
curl --request DELETE \
  --url https://api.instaview.sk/candidates/{id} \
  --header 'Authorization: Bearer <token>'
{
  "statusCode": 200,
  "message": "Success",
  "data": true,
  "traceId": "<string>"
}
Permanently deletes a candidate and their profile. This action cannot be undone.

​
Overview

The delete candidate endpoint permanently removes a candidate’s information and profile from your account. This helps maintain a clean candidate database and ensures data hygiene.

​
Use Cases

  • Remove Duplicates: Clean up duplicate candidate entries
  • GDPR Compliance: Handle data deletion requests for permanent removal
  • Pipeline Cleanup: Remove candidates who are no longer in consideration
  • Data Management: Maintain a clean candidate database

​
Permanent Deletion Behavior

Deleting a candidate permanently removes their profile and all associated personal data from your account. This action is irreversible.

​
Impact on Existing Interviews

Deleting a candidate does not affect existing interviews. Those interviews retain their association with the candidate for historical accuracy. However, you cannot create new interviews for a deleted candidate.

​
GDPR Considerations

For GDPR “right to be forgotten” requests requiring permanent deletion, contact support. Soft deletion maintains audit trails while removing candidates from active operations.

​
Company Isolation

You can only delete candidates that are associated with jobs in your API key’s company. The API validates company ownership before allowing deletion.

​
Error Scenarios

  • 404 Not Found: Candidate doesn’t exist or has already been deleted
  • 403 Forbidden: Candidate’s job belongs to a different company

Candidates Resource Guide

Learn about candidate management

List Candidates

View all active candidates

Create Candidate

Create new candidates

Authorizations

​
Authorization
string
header
required

API key for authentication using Bearer scheme

Path Parameters

​
id
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

200 - application/json
​
statusCode
integer
required
Example:

200

​
message
string
required
Example:

"Success"

​
data
boolean
required
​
traceId
string | null