Skip to main content
DELETE
/
jobs
/
{id}
Delete job
curl --request DELETE \
  --url https://api.instaview.sk/jobs/{id} \
  --header 'Authorization: Bearer <token>'
true
Permanently deletes a job posting. This action cannot be undone.

​
Overview

The delete job endpoint permanently removes a job posting from your account. This will also clear all candidate assignments specifically related to this job.

​
Use Cases

  • Remove Obsolete Jobs: Clean up jobs that are no longer relevant
  • Archive Old Postings: Permanently remove outdated job postings
  • Compliance: Delete jobs for data retention compliance
  • Organization: Maintain a clean job library

​
Permanent Deletion Behavior

Deleting a job permanently removes the posting from your account. This action is irreversible and will also clear any existing candidate links to this specific job.

​
Impact on Existing Data

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

​
Company Isolation

You can only delete jobs that belong to your API key’s company. Attempting to delete a job from another company will result in a 403 Forbidden error.

​
Error Scenarios

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

Jobs Resource Guide

Learn about job management

List Jobs

View all active jobs

Create Job

Create new job postings

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

The response is of type boolean.