Purple8-platform

API Endpoint Reference - Purple8 Platform

Gateway Configuration

Gateway Service: Runs on port 8081 (not 8000 or 8001) Frontend: Runs on port 8080 (nginx) Correct API Base URL: http://localhost:8081

Router Prefixes

The FastAPI gateway has multiple routers with different prefix configurations:

Routers WITHOUT /api prefix:

• Pipeline: /pipeline/*
  • /pipeline/run (POST)
  • /pipeline/stream (GET)
  • /pipeline/projects (GET)
  • /pipeline/logs (GET)
  • /pipeline/approve (POST)
  • /pipeline/iterate (POST)
  • /pipeline/reject (POST)
  • /pipeline/refine-agent (POST)
  • /pipeline/analyze-context (POST)
• GitHub: /github/*
  • /github/validate-token (POST)
  • /github/organizations (POST)
  • /github/repos (POST)
  • /github/create-and-push (POST)
  • /github/push-code (POST)
  • /github/pull-repo (POST)
• Health: /health/*
  • /health/ (GET)
  • /health/ready (GET)
  • /health/live (GET)
• Approvals: /approvals/*
  • /approvals/request (POST)
  • /approvals/pending (GET)
  • /approvals/{approval_id}/decide (POST)

Routers WITH /api prefix:

• Sandbox: /api/sandbox/*
  • /api/sandbox/sessions (GET, POST)
  • /api/sandbox/sessions/{session_id} (GET, DELETE)
  • /api/sandbox/sessions/{session_id}/execute (POST)
  • /api/sandbox/health (GET)
  • /api/sandbox/stats (GET)
  • /api/sandbox/validate/pipeline (POST)
• Deploy: /api/deploy/*
  • /api/deploy/projects (GET)
  • /api/deploy/project (POST)
  • /api/deploy/project/{project_name} (GET, DELETE)
  • /api/deploy/project/{project_name}/load (POST)
• Artifacts: /api/artifacts/*
  • /api/artifacts/generate (POST)
  • /api/artifacts/{project_id}/download (GET)
  • /api/artifacts/project/{project_name}/download (GET)
• Rework: /api/rework/*
  • /api/rework/project/{project_name}/security (POST)
  • /api/rework/project/{project_name}/bugfix (POST)
  • /api/rework/agent/rework (POST)
• BRD: /api/brd/*
  • /api/brd/generate (POST)
  • /api/brd/enhance (POST)
• Models: /api/models/*
  • /api/models/select (POST)
  • /api/models/catalog (GET)
  • /api/models/openai/live (GET)
  • /api/models/google/live (GET)
• Admin: /api/admin/*
  • /api/admin/system/status (GET)
  • /api/admin/services/restart (POST)
  • /api/admin/docker/restart/{service} (POST)
• Agents: /api/agents/*
  • /api/agents/ (GET)
  • /api/agents/{agent_id} (GET)
  • /api/agents/{agent_id}/execute (POST)
• Context: /api/context/*
  • /api/context/optimize (POST)
  • /api/context/analyze-relevance (POST)
• Checkpoints: /api/checkpoints/*
  • /api/checkpoints/ (GET)
  • /api/checkpoints/{checkpoint_id} (GET, DELETE)

• Memory: /api/memory/* (prefix added in main.py)

• CoT: /api/cot/* (Chain of Thought)
  • /api/cot/stream (POST)
  • /api/cot/analyze (POST)
• Agent Learning: /api/agent-learning/*
  • /api/agent-learning/lessons (GET)
  • /api/agent-learning/stats (GET)

Common Mistakes

❌ WRONG:

// Wrong - adds /api to base URL
const API_BASE = 'http://localhost:8081/api'
fetch(`${API_BASE}/pipeline/projects`) // → /api/pipeline/projects (404!)

// Wrong - incorrect port
const API_BASE = 'http://localhost:8000'
const API_BASE = 'http://localhost:8001'

✅ CORRECT:

// Correct - gateway base URL without /api
const API_BASE = 'http://localhost:8081'

// For pipeline endpoints (no /api prefix)
fetch(`${API_BASE}/pipeline/projects`) // → /pipeline/projects ✓

// For sandbox endpoints (has /api prefix)
fetch(`${API_BASE}/api/sandbox/health`) // → /api/sandbox/health ✓

Frontend Configuration Files

Files that need updating:

1. src/config.js - Main config file
   • Currently uses: window.location.hostname:8001
   • Should use: 8081
2. src/services/pipelineApi.js
   • Currently: http://localhost:8001
   • Should be: http://localhost:8081
3. src/services/sandboxApi.js
   • Currently: http://localhost:8001
   • Should be: http://localhost:8081
4. src/services/memoryApi.js
   • Currently: http://localhost:8001
   • Should be: http://localhost:8081
5. src/services/cotApi.js
   • Currently: http://localhost:8001
   • Should be: http://localhost:8081
6. src/services/proactiveApi.js
   • Currently: http://localhost:8001
   • Should be: http://localhost:8081
7. src/services/previewApi.js
   • Currently: http://localhost:8001
   • Should be: http://localhost:8081
8. src/store/adminStore.js
   • Currently: http://localhost:8001
   • Should be: http://localhost:8081
9. src/components/AdminControlPanel.vue
   • Hardcoded: http://localhost:8000/api/admin/*
   • Should use: http://localhost:8081/api/admin/*
10. src/components/sandbox/IDECopilot.vue
    • Currently: http://localhost:8000
    • Should be: http://localhost:8081
11. src/config/constants.js
    • Currently: http://localhost:8000
    • Should be: http://localhost:8081
12. src/composables/usePipelineExecution.js
    • Error message references: http://localhost:8000
    • Should be: http://localhost:8081

Environment Variables

Production: Set VUE_APP_API_URL environment variable:

VUE_APP_API_URL=https://api.yourdomain.com

Development: Default to http://localhost:8081

Testing Endpoints

# Test correct endpoints
curl http://localhost:8081/health
curl http://localhost:8081/pipeline/projects
curl http://localhost:8081/api/sandbox/health
curl http://localhost:8081/api/deploy/projects

# These should return 404
curl http://localhost:8081/api/pipeline/projects  # 404
curl http://localhost:8081/sandbox/health          # 404
curl http://localhost:8081/api/github/repos        # 404

Port Summary

Service	Port	Purpose
Frontend (nginx)	8080	Vue.js application
Gateway (FastAPI)	8081	Main API Gateway
Agent Service	8001	Agent execution service
Workflow Service	8002	Workflow orchestration
PostgreSQL	5434	Database
Redis	6381	Cache
RabbitMQ	5672, 15672	Message queue
Qdrant	6333-6334	Vector database
Qdrant Builder	6335-6336	Builder vector database
MinIO	9000-9001	Object storage

Migration Checklist

When updating frontend to use correct gateway:

• Update all localhost:8000 → localhost:8081
• Update all localhost:8001 → localhost:8081
• Remove /api from base URLs for pipeline/github/health endpoints
• Keep /api prefix when calling sandbox/deploy/artifacts/admin endpoints
• Test all critical user flows
• Update error messages with correct port
• Update documentation

---

Last Updated: February 4, 2026
Version: 2.1 (Post-Endpoint Validation)