Deactivate Company Account

Deactivate the authenticated company account

DELETE /api/v1/companies/me

Deactivate Company Account

cURL

curl --request DELETE \
  --url https://api.example.com/api/v1/companies/me

import requests

url = "https://api.example.com/api/v1/companies/me"

response = requests.delete(url)

print(response.text)

const options = {method: 'DELETE'};

fetch('https://api.example.com/api/v1/companies/me', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/v1/companies/me",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/v1/companies/me"

	req, _ := http.NewRequest("DELETE", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.delete("https://api.example.com/api/v1/companies/me")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/v1/companies/me")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)

response = http.request(request)
puts response.read_body

Endpoint

DELETE /api/v1/companies/me

Base URL: http://localhost:3000/api/v1

This endpoint requires Company authentication.

Headers

Header	Value
Authorization	Bearer

Description

This endpoint deactivates the company account. The account and all associated data (jobs, applications) will be hidden but not permanently deleted.

Response

{
  "success": true,
  "data": {
    "id": "uuid"
  },
  "message": "Company deactivated successfully",
  "meta": {
    "timestamp": "2026-04-23T20:00:00.000Z",
    "path": "/companies/me",
    "method": "DELETE"
  }
}

Error Responses

401 Unauthorized

{
  "success": false,
  "error": {
    "message": "Unauthorized",
    "statusCode": 401,
    "timestamp": "2026-04-23T20:00:00.000Z",
    "path": "/companies/me",
    "method": "DELETE",
    "details": "Unauthorized"
  }
}

403 Forbidden

{
  "success": false,
  "error": {
    "message": "Forbidden resource",
    "statusCode": 403,
    "timestamp": "2026-04-23T20:00:00.000Z",
    "path": "/companies/me",
    "method": "DELETE",
    "details": "Forbidden"
  }
}

404 Not Found

{
  "success": false,
  "error": {
    "message": "Company not found or already deactivated",
    "statusCode": 404,
    "timestamp": "2026-04-23T20:00:00.000Z",
    "path": "/companies/me",
    "method": "DELETE",
    "details": "Not Found"
  }
}