Delete Contact Request
Permanently remove a contact request from the system. This operation cannot be undone.
🔹 Endpoint Details
DELETE /api/v1/contact-requests/{id}
🔒 Authentication
| Header | Required | Description |
|---|---|---|
| Content-Type | Yes | Must be application/json |
| Authorization | Yes | Format: ONLIVESITE Credential:ONLIVEAccessKeyId, Signature=CalculatedSignature |
📝 Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string (UUID) | Yes | ID of the contact request to delete |
🧩 Request Example
curl -X DELETE "https://openapi.onlive.site/api/v1/contact-requests/123e4567-e89b-12d3-a456-426614174000" \
-H "Content-Type: application/json" \
-H "Authorization: ONLIVESITE Credential:ONLIVEAccessKeyId, Signature=CalculatedSignature"
📥 Response
Success Response (200 OK)
Returns the deleted Contact Request entity.
Response Example
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"organizationId": "123e4567-e89b-12d3-a456-426614174001",
"organizationName": "Acme Inc.",
"type": "contactmeback",
"status": "rejected",
"preferredContact": "email",
"name": "John Doe",
"phone": "+33612345678",
"message": "Please send me a copy of the contract",
"relatedService": "7a96c97a-bcf9-42df-984a-051c0fb8487e",
"extraFields": { "department": "Sales" },
"userGroupId": "550e8400-e29b-41d4-a716-446655440000",
"userGroup": "Sales Team",
"taxonomies": ["/model/contact-request"],
"externalId": "frm_abc123",
"communicationLogs": [],
"countCommunicationLogs": 0,
"createdAt": "2025-05-13T15:00:00Z",
"updatedAt": "2025-05-13T17:05:22Z"
}
❌ Error Responses
| Status | Description |
|---|---|
| 404 | Contact request not found |
This endpoint follows the standard error format.
📘 Notes
- Deletion is permanent and cannot be undone
- The contact request must belong to your organization
- You must have appropriate permissions to delete contact requests
✅ Common Use Cases
- 🧹 Cleanup: Remove duplicate or test contact requests
- 🔒 Compliance: Erase contact requests on right-to-be-forgotten requests
- 🗑️ Spam: Discard contact requests flagged as spam