Reach It
- Method:
POST - Path:
/api/logs/clear - Base URL:
http://openhaldex.local(or controller IP) - Response format:
JSON
API Endpoint
Clear Log Scope
Clears selected log scope.
Query Input
None
Body Input
JSON: {"scope":"all|can|error|everything"} (default everything).
Response / Parse
Receive: JSON: ok,debugCaptureActive,disableController
Parse: Unsupported scope fails.
Error Behavior
400 clear failed/invalid json; 200 success
Example Call
curl -s -X POST "http://openhaldex.local/api/logs/clear" -H "Content-Type: application/json" -d '{...}'Endpoint-Specific Engineering Notes
This section is intentionally unique for POST /api/logs/clear. Focus area:
scope-level log reset for controlled troubleshooting sessions. When integrating OpenHaldex at scale, this endpoint should be treated as a dedicated
workflow step rather than a generic HTTP action.
Operational scenario: Clear selected scope before reproducing an issue so resulting logs contain only relevant events.
Domain vocabulary: scope-clear, all-reset, can-reset, error-reset, fresh-capture, troubleshoot-window, log-reset, scope-hygiene, clear-operation, diagnostic-baseline.
Common Mistakes for This Endpoint
- Clearing everything without backup
- Wrong scope chosen for investigation
- No user warning about irreversible clear
Practical Validation Pattern
- Prepare endpoint-specific payload and validate types/ranges before send.
- Execute
POST /api/logs/clearand capture status code + raw response. - Parse response and apply only validated fields to UI state.
- Run a follow-up read (usually
/api/status) to verify runtime convergence. - Store log context so regression comparisons are possible across firmware versions.
Reference Snippet
await fetch('/api/logs/clear',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({scope:'can'})});
Unique endpoint guidance like this helps prevent duplicate-content clustering while remaining genuinely useful for developers working on OpenHaldex integrations for haldex controller, VW AWD controller, and Audi AWD controller environments.
Project Backlinks
Try the OpenHaldex Firmware Demo
Preview the real OpenHaldex firmware UI in your browser with simulated live CAN traffic and interactive pages for tuning, diagnostics, logs, setup, and OTA workflows.