re org

docs/20-API/ENDPOINTS.md

@@ -1,7 +1,7 @@
 # API Endpoints Reference
 
-**Last Verified:** January 3, 2026  
-**Version:** 1.3.2  
+**Last Verified:** January 17, 2026  
+**Version:** 1.8.0  
 **Base URL:** `/api/v1/`  
 **Documentation:** `/api/docs/` (Swagger) | `/api/redoc/` (ReDoc)
 
@@ -149,7 +149,51 @@ POST /api/v1/writer/content/{id}/schedule/
 | POST | `/site_sync/` | Site-level sync | Sync by site ID |
 | POST | `/webhook/wordpress/` | WordPress webhook | Receive WP updates |
 
-### Publishing Settings Endpoints (v1.3.2)
+### Unified Settings Endpoints (v1.8.0)
+
+| Method | Path | Handler | Purpose |
+|--------|------|---------|---------|
+| GET | `/sites/{site_id}/unified-settings/` | `UnifiedSiteSettingsViewSet.retrieve` | Get all site settings (automation, publishing, AI) |
+| PATCH | `/sites/{site_id}/unified-settings/` | `UnifiedSiteSettingsViewSet.partial_update` | Update settings (partial) |
+
+**Unified Settings Response:**
+```json
+{
+  "automation_config": {
+    "enabled": true,
+    "frequency": "daily",
+    "scheduled_days": ["mon", "wed", "fri"],
+    "scheduled_time": "09:00:00",
+    "next_run_at": "2026-01-18T09:00:00Z",
+    "stage_1_enabled": true, "stage_1_batch_size": 50, "max_keywords_per_run": 100,
+    "stage_2_enabled": true, "stage_2_batch_size": 10, "max_clusters_per_run": 20,
+    // ... stages 3-7
+  },
+  "publishing_settings": {
+    "auto_approval_enabled": true,
+    "auto_publish_enabled": true,
+    "daily_publish_limit": 3,
+    "weekly_publish_limit": 15,
+    "monthly_publish_limit": 50,
+    "publish_days": ["mon", "tue", "wed", "thu", "fri"],
+    "publish_time_slots": [{"start": "09:00", "end": "17:00"}],
+    "total_items_per_run": 500
+  },
+  "stage_configs": [
+    {"stage": 1, "enabled": true, "batch_size": 50, "max_per_run": 100},
+    // ... stages 2-7
+  ],
+  "ai_settings": {
+    "testing_model_id": 2,
+    "live_model_id": 1,
+    "image_model_id": 3
+  }
+}
+```
+
+### Publishing Settings Endpoints (deprecated v1.8.0)
+
+> ⚠️ **Deprecated:** Use `/sites/{site_id}/unified-settings/` instead
 
 | Method | Path | Handler | Purpose |
 |--------|------|---------|---------|