Skip to main content
DELETE
/
company
/
{id}
Permanently delete company
curl --request DELETE \
  --url https://api.instaview.sk/company/{id} \
  --header 'Authorization: Bearer <token>'
{
  "statusCode": 200,
  "message": "Success",
  "data": true,
  "traceId": "<string>"
}
Permanently deletes a specific company by ID. Access rules differ between regular API keys and ATS integration keys.

​
Overview

The delete company endpoint permanently removes a company and all its associated resources (jobs, candidates, interviews, etc.). This action is irreversible.

​
Access Rules

​
Regular API Keys

Regular API keys can only delete their associated company: 
// ✅ Can delete own company
DELETE /company/{own-company-id}

// ❌ Cannot delete other companies
DELETE /company/{other-company-id}
// Returns: 403 Forbidden

​
ATS Integration Keys

ATS keys can delete any company they’ve created: 
// ✅ Can delete companies created by this ATS key
DELETE /company/{ats-managed-company-id}

// ❌ Cannot delete companies not managed by this ATS key
DELETE /company/{unmanaged-company-id}
// Returns: 403 Forbidden

ATS Integration Guide

Learn about ATS integration keys and access rules

Companies Resource Guide

Understand company management

Authorizations

​
Authorization
string
header
required

API key for authentication using Bearer scheme

Path Parameters

​
id
string<uuid>
required

Response

200 - application/json

Company permanently deleted successfully

​
statusCode
integer
required
Example:

200

​
message
string
required
Example:

"Success"

​
data
boolean
required
​
traceId
string | null