Destructive Operation: This endpoint permanently deletes a company record from the database. This operation cannot be undone. Use with extreme caution.
Permanently deletes a company record from the database (hard-delete operation). Validates that the record exists before attempting permanent deletion. Completely removes the record from the database.
Endpoint
Authentication
This endpoint may require authentication depending on your security configuration. Include a valid bearer token in the Authorization header if required.
Permission Required: company:purge (if authentication is enabled)
Path Parameters
Response
Success Response (200 OK)
Returns an empty data object indicating successful permanent deletion.
Error Responses
401 Unauthorized - Missing or invalid authentication token
403 Forbidden - Insufficient permissions
404 Not Found - Record not found
Important Notes
- This operation is irreversible. Once a record is purged, it cannot be recovered.
- The record is completely removed from the database using a DELETE query.
- Use this endpoint only when you are absolutely certain that the record should be permanently deleted.
- Consider using the soft-delete endpoint (
DELETE /api/v3/product/company/{documentId}) instead for data retention purposes.
Examples
Basic Request