export: align reanimator contract v2.7

bible-local/03-api.md

@@ -55,6 +55,23 @@ Responses:
 - `400` on malformed JSON
 - `422` on validation errors
 
+Optional request field:
+- `power_on_if_host_off`: when `true`, Redfish collection may power on the host before collection if preflight found it powered off
+
+### `POST /api/collect/probe`
+
+Checks that live API connectivity works and returns host power state before collection starts.
+
+Typical request body is the same as `POST /api/collect`.
+
+Typical response fields:
+- `reachable`
+- `protocol`
+- `host_power_state`
+- `host_powered_on`
+- `power_control_available`
+- `message`
+
 ### `GET /api/collect/{id}`
 
 Returns async collection job status, progress, timestamps, and accumulated logs.