Skip to content

Orchestrators API

The Orchestrators API provides access to 28 enterprise-grade orchestrators for automated workflows and AI operations.

Endpoints

List Orchestrators

GET /api/v1/orchestrators

Response: 

{
  "success": true,
  "orchestrators": [
    {
      "id": "code_review_orchestrator",
      "name": "Code Review Orchestrator",
      "description": "Automated code review with AI analysis",
      "tier": "P0_foundation",
      "costPerRun": 0.15,
      "averageRuntime": 45.2,
      "successRate": 98.7,
      "status": "active"
    }
  ],
  "total": 28,
  "categories": {
    "P0_foundation": 6,
    "P1_advanced": 12,
    "P2_specialized": 10
  }
}

Execute Orchestrator

POST /api/v1/orchestrators/{orchestrator_id}/execute

Request Body: 

{
  "parameters": {},
  "priority": "normal",
  "sessionId": "session_123"
}

Response: 

{
  "success": true,
  "executionId": "exec_456",
  "orchestratorId": "code_review_orchestrator", 
  "status": "running",
  "estimatedCompletion": "2025-08-12T14:05:00Z",
  "costEstimate": 0.15
}

Get Execution Status

GET /api/v1/orchestrators/execution/{execution_id}/status

Response: 

{
  "success": true,
  "executionId": "exec_456",
  "status": "completed",
  "progress": 100,
  "startTime": "2025-08-12T14:00:00Z",
  "endTime": "2025-08-12T14:04:32Z",
  "result": {},
  "actualCost": 0.12
}

Get Execution Logs

GET /api/v1/orchestrators/execution/{execution_id}/logs

Response: 

{
  "success": true,
  "executionId": "exec_456",
  "logs": [
    {
      "timestamp": "2025-08-12T14:00:01Z",
      "level": "info",
      "message": "Starting code review analysis",
      "component": "analyzer"
    }
  ],
  "totalLogs": 15
}

Available Orchestrators

Foundation Tier (P0)

  • Code Review Orchestrator - AI-powered code analysis
  • Testing Suite Manager - Automated testing workflows
  • Deployment Coordinator - Release management
  • Security Scanner - Vulnerability assessment
  • Performance Optimizer - System optimization
  • Documentation Generator - Auto-documentation

Advanced Tier (P1)

  • Multi-Model AI Router - Intelligent model selection
  • Cost Optimization Engine - Budget management
  • Workflow Orchestrator - Complex multi-step processes
  • Data Pipeline Manager - ETL and data processing
  • Integration Controller - API and service integration
  • Monitoring Coordinator - System health management

Specialized Tier (P2)

  • Enterprise Analytics - Business intelligence
  • Compliance Auditor - Regulatory compliance
  • DevOps Automation - Infrastructure management
  • Quality Assurance - QA workflow automation
  • Customer Intelligence - CRM and support automation
  • Financial Controller - Financial workflow management

Status Codes

  • pending - Queued for execution
  • running - Currently executing
  • completed - Successfully completed
  • failed - Execution failed
  • cancelled - Manually cancelled

Error Responses

Invalid Orchestrator

{
  "success": false,
  "error": "Orchestrator not found",
  "code": "ORCHESTRATOR_NOT_FOUND"
}

Execution Failed

{
  "success": false,
  "error": "Orchestrator execution failed",
  "code": "EXECUTION_FAILED",
  "details": "Error details here"
}

Generated on 2025-08-12 14:48:04