Delete log

DELETE /api/request-logs/{unique_id}/

Python

import requests

unique_id = "log_abc123..."  # Replace with actual log ID
url = f"https://api.keywordsai.co/api/request-logs/{unique_id}/"

headers = {
    "Authorization": f"Bearer {YOUR_KEYWORDS_AI_API_KEY}"
}

response = requests.delete(url, headers=headers)

if response.status_code == 204:
    print("Log deleted successfully")
else:
    print(f"Error: {response.status_code}")
    print(response.json())

204 No Content

(Empty response body)

The Delete Log endpoint permanently removes a log from the system.

This operation is irreversible. The log will be permanently deleted and cannot be recovered. Use with caution.

Path parameters

unique_id · string · required

The unique ID of the log to delete. You can get this from the List Logs endpoint.

Response

Returns HTTP 204 No Content on successful deletion with no response body.

Python

import requests

unique_id = "log_abc123..."  # Replace with actual log ID
url = f"https://api.keywordsai.co/api/request-logs/{unique_id}/"

headers = {
    "Authorization": f"Bearer {YOUR_KEYWORDS_AI_API_KEY}"
}

response = requests.delete(url, headers=headers)

if response.status_code == 204:
    print("Log deleted successfully")
else:
    print(f"Error: {response.status_code}")
    print(response.json())

204 No Content

(Empty response body)

Error Responses

404 Not Found

{
  "detail": "Log not found"
}

401 Unauthorized

{
  "detail": "Your API key is invalid or expired, please check your API key at https://platform.keywordsai.co/platform/api/api-keys"
}

Use Cases

Delete test logs

# Delete all test logs after testing
import requests

# First, list test logs
list_response = requests.get(
    "https://api.keywordsai.co/api/request-logs/",
    headers={"Authorization": f"Bearer {YOUR_API_KEY}"},
    params={
        "is_test": "true",
        "page_size": 100
    }
)

logs = list_response.json()["results"]

# Delete each test log
for log in logs:
    delete_response = requests.delete(
        f"https://api.keywordsai.co/api/request-logs/{log['unique_id']}/",
        headers={"Authorization": f"Bearer {YOUR_API_KEY}"}
    )
    if delete_response.status_code == 204:
        print(f"Deleted log {log['unique_id']}")

Delete logs with sensitive data

# Delete logs containing specific metadata
import requests

# List logs with sensitive flag
list_response = requests.post(
    "https://api.keywordsai.co/api/request-logs/",
    headers={"Authorization": f"Bearer {YOUR_API_KEY}"},
    json={
        "filters": {
            "metadata__contains_pii": {
                "operator": "",
                "value": [True]
            }
        }
    }
)

logs = list_response.json()["results"]

# Delete each log
for log in logs:
    requests.delete(
        f"https://api.keywordsai.co/api/request-logs/{log['unique_id']}/",
        headers={"Authorization": f"Bearer {YOUR_API_KEY}"}
    )

Bulk delete with confirmation

# Safe bulk delete with confirmation
import requests

def bulk_delete_logs(log_ids, api_key):
    """Delete multiple logs with progress tracking"""
    deleted_count = 0
    failed_count = 0
    
    print(f"Preparing to delete {len(log_ids)} logs...")
    confirmation = input("Type 'DELETE' to confirm: ")
    
    if confirmation != "DELETE":
        print("Deletion cancelled")
        return
    
    for log_id in log_ids:
        response = requests.delete(
            f"https://api.keywordsai.co/api/request-logs/{log_id}/",
            headers={"Authorization": f"Bearer {api_key}"}
        )
        
        if response.status_code == 204:
            deleted_count += 1
        else:
            failed_count += 1
            print(f"Failed to delete {log_id}: {response.status_code}")
    
    print(f"Deleted: {deleted_count}, Failed: {failed_count}")

# Usage
log_ids_to_delete = ["log_1", "log_2", "log_3"]
bulk_delete_logs(log_ids_to_delete, YOUR_API_KEY)

Best Practices

Before deleting logs:

1. Export important data: Use the export endpoint to backup logs before deletion
2. Verify filters: When bulk deleting, test your filters with the list endpoint first
3. Consider alternatives: For privacy compliance, consider using the blurred field instead of deletion
4. Audit trail: Keep a record of deleted log IDs for compliance purposes

Related Endpoints

• List Logs - Get log IDs for deletion
• Get Log - Verify log contents before deletion
• Update Log - Alternative: update metadata instead of deleting