Skip to main content
The Kubiya Control Plane API is a multi-tenant AI agent orchestration and management platform built with FastAPI, Temporal, and PostgreSQL.

Features

  • Multi-tenant Architecture: Manage multiple projects, teams, and agents
  • Workflow Orchestration: Temporal-based workflow execution
  • Flexible Agent Runtime: Support for multiple agent types and skills
  • Policy Enforcement: OPA-based policy engine for agent governance
  • Scalable Workers: Distributed worker architecture for agent execution
  • Context Management: Environment and team-specific context handling
  • LLM Integration: Support for multiple LLM providers via LiteLLM
  • Comprehensive APIs: RESTful APIs for all platform features

API Resources

The Control Plane API provides the following resources:
ResourceEndpointDescription
Projects/api/v1/projectsMulti-project management
Environments/api/v1/environmentsEnvironment configuration
Agents/api/v1/agentsAgent management
Teams/api/v1/teamsTeam management
Workflows/api/v1/workflowsWorkflow definitions
Executions/api/v1/executionsExecution tracking
Workers/api/v1/workersWorker registration and management
Skills/api/v1/skillsTool sets and definitions
Policies/api/v1/policiesPolicy management and enforcement
Secrets/api/v1/secretsSecrets management (proxies to Kubiya)
Integrations/api/v1/integrationsThird-party integrations
Models/api/v1/modelsLLM model configuration
Health/api/healthHealth check endpoint
Task Planning/api/v1/task-planningAI-powered task planning

Architecture

Workflow Orchestration

The platform uses Temporal for reliable workflow execution:
  • Durable execution with automatic retries
  • Activity-based task decomposition
  • Support for long-running workflows
  • Built-in observability and monitoring

Multi-tenancy

  • Projects: Top-level isolation boundary
  • Environments: Isolated execution contexts within projects
  • Teams: Collaborative agent groups
  • Agents: Individual agent instances

Worker Architecture

Workers pull tasks from environment-specific queues and execute agent workflows using Temporal.