Skip to main content
DELETE
/
jobs
/
{id}
Delete job
curl --request DELETE \
  --url https://api.instaview.sk/jobs/{id} \
  --header 'Authorization: Bearer <token>'
true
Soft-deletes a job posting by ID. Deleted jobs are not permanently removed but are hidden from list operations.

​
Overview

The delete job endpoint performs a soft delete, meaning the job is marked as deleted but not permanently removed from the system. This preserves data integrity and maintains relationships with existing candidates and interviews.

​
Use Cases

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

​
Soft Delete Behavior

Deleted jobs are soft-deleted, meaning they are hidden from list and get operations but remain in the database for audit purposes. They cannot be used for new candidate creation.

​
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

Response

200 - application/json

The response is of type boolean.