Skip to main content

POST /system/reset

Stop fault injection and return to healthy monitoring with true recovery. This allows the system to naturally recover from faults while continuing to track the Degradation Index.

Query Parameters

asset_id
string
default:"Motor-01"
Asset identifier to reset

Response

status
string
Action status: reset
message
string
Human-readable status message
state
string
New system state: MONITORING_HEALTHY

Example

cURL
curl -X POST "https://predictive-maintenance-uhlb.onrender.com/system/reset?asset_id=Motor-01"
Response
{
  "status": "reset",
  "message": "System reset to healthy monitoring.",
  "state": "MONITORING_HEALTHY"
}

Behavior

When you call /system/reset:
  1. Stops fault injection - Background thread terminates
  2. Transitions to MONITORING_HEALTHY - System returns to normal operation
  3. Resumes healthy data generation - 100Hz sensor readings with healthy baseline patterns
  4. Continues DI tracking - The Degradation Index is NOT reset (use /system/purge for that)
  5. Natural recovery - Health score may improve if the system operates within healthy parameters
Key Difference from Purge: /reset stops the fault but preserves the Degradation Index history. Use this to simulate a maintenance action that returns the asset to normal operation without a full system reset.

State Requirements

Current StateCan Reset?
IDLE❌ No
CALIBRATING❌ No
MONITORING_HEALTHY✅ Yes (no-op)
FAULT_INJECTION✅ Yes
You can only reset when in MONITORING_HEALTHY or FAULT_INJECTION state. Attempting to reset from other states will return a 400 error.

Status Codes

  • 200 - Reset successful
  • 400 - Invalid state transition

Use Cases

Simulated Maintenance

Reset after fault injection to simulate maintenance intervention

Recovery Testing

Test how quickly the system recovers from faults

DI Persistence

Verify that DI continues to track cumulative damage

Manual Intervention

Stop faults manually via dashboard or API

Comparison with Other Endpoints

EndpointStops Fault?Resets DI?Returns to State
/system/reset✅ Yes❌ NoMONITORING_HEALTHY
/system/stop✅ Yes❌ NoIDLE
/system/purge✅ Yes✅ YesIDLE
Use /reset when you want to return to normal operation while preserving cumulative health history.

Inject Fault

Start fault injection

Stop Session

Return to IDLE state

Purge System

Full system reset with DI=0

System State

Check current state

Build docs developers (and LLMs) love