> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bbrands.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Purge Company

<Warning>**Destructive Operation**: This endpoint permanently deletes a company record from the database. This operation cannot be undone. Use with extreme caution.</Warning>

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

```
DELETE /api/v3/product/company/{documentId}/purge
```

## 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

<ParamField name={'documentId'} required={true} type={'uuid'} visibility={'public'}>
  The unique document identifier of the company record to permanently delete. Must be a valid UUID format.
</ParamField>

## Response

### Success Response (200 OK)

Returns an empty data object indicating successful permanent deletion.

```json theme={null}
{
  "message": "Company record permanently deleted successfully",
  "data": {},
  "meta": {
    "correlation": "29146752-ef3a-4569-b397-ff2144412c4a",
    "status": 200,
    "timestamp": "2024-01-01T00:00:00.000Z"
  }
}
```

### Error Responses

**401 Unauthorized** - Missing or invalid authentication token

**403 Forbidden** - Insufficient permissions

**404 Not Found** - Record not found

```json theme={null}
{
  "error": {
    "code": "NOT_FOUND",
    "message": "Record with document_id '550e8400-e29b-41d4-a716-446655440000' not found"
  },
  "meta": {
    "correlation": "...",
    "status": 404,
    "timestamp": "..."
  }
}
```

## Important Notes

<Warning>
  * **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.
</Warning>

## Examples

### Basic Request

```bash theme={null}
curl -X DELETE 'https://api.bbrands.io/api/v3/product/company/550e8400-e29b-41d4-a716-446655440000/purge' \
  -H 'Authorization: Bearer YOUR_TOKEN'
```