dos updates

docs/20-API/ENDPOINTS.md

@@ -1,7 +1,7 @@
 # API Endpoints Reference
 
-**Last Verified:** January 19, 2026  
-**Version:** 1.8.2  
+**Last Verified:** January 20, 2026  
+**Version:** 1.8.4  
 **Base URL:** `/api/v1/`  
 **Documentation:** `/api/docs/` (Swagger) | `/api/redoc/` (ReDoc)
 
@@ -457,9 +457,35 @@ GET /api/v1/integration/settings/defaults/
 | GET | `/history/` | History | Past runs |
 | GET | `/logs/` | Logs | Activity log |
 | GET | `/estimate/` | Estimate | Credit estimate |
+| **GET** | `/runs/` | **v1.8.0** List runs | All automation runs (paginated) |
+| **GET** | `/runs/{id}/` | **v1.8.0** Run detail | Single run with stages, logs |
 
 **Query Parameters:** All require `?site_id=`, run-specific require `?run_id=`
 
+### Automation Runs Response (v1.8.0)
+
+```json
+GET /api/v1/automation/runs/?site_id=1
+
+{
+  "count": 25,
+  "results": [
+    {
+      "id": 1,
+      "site": 1,
+      "status": "completed",
+      "started_at": "2026-01-18T09:00:00Z",
+      "completed_at": "2026-01-18T09:45:00Z",
+      "current_stage": 7,
+      "total_stages": 7,
+      "items_processed": 150,
+      "credits_used": 450,
+      "error_message": null
+    }
+  ]
+}
+```
+
 ---
 
 ## Linker Endpoints (`/api/v1/linker/`)