API: Agents

Overview

The agents API provides visibility into the active AI agents managing your infrastructure. Each agent specializes in a specific resource domain and reports its current status and managed resource count.

Endpoint

## List Agents

GET /v1/agents

Response (200)

{
  "items": [
    {"name": "orchestrator", "status": "active", "managed_resources": 0, "description": "Coordinates multi-service deployments"},
    {"name": "instance-agent", "status": "active", "managed_resources": 8, "description": "Manages compute instances"},
    {"name": "database-agent", "status": "active", "managed_resources": 3, "description": "Manages PostgreSQL and MySQL databases"},
    {"name": "vpc-agent", "status": "active", "managed_resources": 5, "description": "Manages VPCs, subnets, and security groups"},
    {"name": "loadbalancer-agent", "status": "active", "managed_resources": 2, "description": "Manages HTTP and TCP load balancers"},
    {"name": "dns-agent", "status": "active", "managed_resources": 12, "description": "Manages DNS zones and records"},
    {"name": "k3s-agent", "status": "active", "managed_resources": 2, "description": "Manages K3s Kubernetes clusters"},
    {"name": "redis-agent", "status": "active", "managed_resources": 3, "description": "Manages Redis clusters"},
    {"name": "queue-agent", "status": "active", "managed_resources": 2, "description": "Manages RabbitMQ and NATS queues"},
    {"name": "function-agent", "status": "active", "managed_resources": 6, "description": "Manages serverless functions"},
    {"name": "bucket-agent", "status": "active", "managed_resources": 4, "description": "Manages object storage buckets"},
    {"name": "iac-agent", "status": "active", "managed_resources": 0, "description": "Processes Infrastructure as Code stacks"},
    {"name": "healing-agent", "status": "active", "managed_resources": 0, "description": "Monitors and heals infrastructure issues"}
  ]
}

Agent Status Values