Delete a Person

Delete a person record from the facial recognition system. This operation permanently removes the person and all associated data including face encodings.

Endpoint

DELETE https://api.verifik.co/v2/face-recognition/persons/{id}

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Parameters

Name	Type	Required	Description
id	string	Yes	The unique identifier of the person to delete

Request

Node.js

import axios from 'axios';

const personId = "person_123456789";
const options = {
  method: 'DELETE',
  url: `https://api.verifik.co/v2/face-recognition/persons/${personId}`,
  headers: {
    Accept: 'application/json',
    Authorization: 'Bearer <your_token>'
  }
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

Python

import http.client

conn = http.client.HTTPSConnection("api.verifik.co")

person_id = "person_123456789"
headers = {
    'Accept': "application/json",
    'Authorization': "Bearer <your_token>"
}

conn.request("DELETE", f"/v2/face-recognition/persons/{person_id}", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

Response

200

{
  "success": true,
  "message": "Person deleted successfully",
  "data": {
    "_id": "person_123456789"
  }
}

404

{
  "error": "Person not found",
  "message": "PERSON_NOT_FOUND"
}

401

{
  "error": "Unauthorized",
  "message": "UNAUTHORIZED"
}

Features

• Person Deletion: Permanently delete person records
• Data Cleanup: Removes all associated face encodings and data
• Collection Cleanup: Automatically removes person from collections
• Structured Response: Organized data format for easy integration
• Multiple Programming Languages: Support for JavaScript, Python, PHP, and Swift
• Error Handling: Comprehensive error responses for various scenarios

Notes

• Permanent Action: This operation cannot be undone. All person data will be permanently deleted.
• Collection Impact: The person will be automatically removed from all associated collections.
• Face Encodings: All face encodings associated with this person will be deleted.