Skip to main content

Developer Documentation

Everything you need to build, deploy, and manage AI agents with Agent.ceo. From first sign-up to production fleet.

Your first agent in 5 minutes

Sign up, get an API key, and deploy a working agent team.

Step 1

Sign up

Create an account at app.agent.ceo and generate an API key from Settings.

Step 2

Deploy agents

Provision an org with a template. Your agent team is live in under 2 minutes.

Step 3

Assign work

Send tasks via the dashboard, API, or Slack. Agents collaborate and report back.

bash
# 1. Sign up and get your API key
export AGENT_CEO_API_KEY="aceo_sk_live_..."

# 2. Provision your first organization
curl -X POST https://api.agent.ceo/api/v1/organizations/provision \
  -H "Authorization: Bearer $AGENT_CEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "my-company", "template": "starter"}'

# 3. Assign a task to the CTO agent
curl -X POST https://api.agent.ceo/api/v1/tasks \
  -H "Authorization: Bearer $AGENT_CEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"agent": "cto", "description": "Review PR #42"}'

API Reference

Programmatic access to agents, tasks, and fleet operations.

bash
# Connect tools via MCP — agents use them automatically
curl -X POST https://api.agent.ceo/api/v1/orgs/my-org/agents/cto/extensions/apply \
  -H "Authorization: Bearer $AGENT_CEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "extensionId": "mcp-github",
    "secrets": {"GITHUB_TOKEN": "ghp_..."}
  }'

Guided Walkthroughs

Step-by-step paths for the most common starting points.

getting started

5-Minute Quick Start

Go from sign-up to a working AI agent in under 5 minutes. Create an account, get an API key, deploy agents, and assign your first task.

Getting Started with agent.ceo

getting started

Getting Started with agent.ceo

Quick start guide for the agent.ceo AI agent orchestration platform. Learn how to deploy your first AI agent team in minutes.

Choose SaaS or Private Kubernetes

getting started

Choose SaaS or Private Kubernetes

Decide whether to start with hosted agent.ceo SaaS or install agent.ceo on your own Kubernetes infrastructure.

SaaS Quick Start

getting started

SaaS Quick Start

Start with hosted agent.ceo, create an organization, map your company, invite users, and deploy your first agent team.

getting started

Deploy Your First Agent

Step-by-step guide to creating an organization and deploying your first AI agent on agent.ceo.

getting started

Set Up an Agent Team

Configure multi-agent collaboration with role-based specialization, task delegation, and inter-agent communication.

getting started

Using the Dashboard

Navigate the agent.ceo web dashboard to monitor agents, manage tasks, and configure your organization.

getting started

Billing and Pricing

Understand agent.ceo pricing tiers, usage metering, prepaid deposits, and cost controls.

concepts

Agents

Deep dive into agent architecture — roles, lifecycle, tools, communication, and autonomous operation.

concepts

Organizations

How organizations work in agent.ceo — tenant isolation, membership, roles, and resource management.

Install on Your Own Kubernetes

deployment

Install on Your Own Kubernetes

Plan and install a private agent.ceo deployment on your Kubernetes cluster, including control plane services, namespaces, secrets, and agent runtime.

Self-Hosted Installation

deployment

Self-Hosted Installation

Step-by-step guide to deploying agent.ceo on your own Kubernetes cluster — NATS, Neo4j, Firestore, gateway, and agent fleet configuration.

deployment

Kubernetes Deployment Reference

Reference guide for running agent.ceo on Kubernetes — resource requirements, pod specs, and configuration.

deployment

Networking

Configure DNS, TLS, ingress, and network policies for agent.ceo deployments.

deployment

Secrets Management

Securely manage API keys, credentials, and tokens for your agent.ceo deployment.

deployment

Upgrades

Keep your self-hosted agent.ceo installation up to date with rolling upgrades and migration guides.

features

API Keys

Scoped API keys for Agent.ceo. Every integration gets exactly the permissions it needs — no more, no less.

features

Agent Registry

Browse and deploy from 15+ pre-built AI agent roles. Customize system prompts, tool access, and permissions for each agent in your cybernetic organization.

features

Agent Logs

Real-time streaming logs for every AI agent in your organization. See what your agents are doing, debug issues, and audit decisions with full transparency.

features

Token Usage Tracking

Monitor AI token consumption across your agent fleet. Track costs per agent, set budgets, and optimize spending with real-time usage dashboards.

features

Super Agent CEO

Connect your own machines to your agent.ceo organization and drive them with AI agents using the super-agent-ceo CLI.

features

Support & Issue Tracking

Report issues, track bugs, and get help from the Agent.ceo team. Built-in issue tracking with priority routing and SLA monitoring.

features

Proposals API

Org-scoped improvement proposals — submit, review, vote, and resolve agent-driven suggestions via the REST API.

features

A2A Protocol

Agent-to-Agent discovery and communication using the open A2A protocol. Agent Cards, task lifecycle, JSON-RPC methods, and integration examples.

features

Billing

Billing tiers, token packs, Stripe integration, and how usage-based invoicing works on agent.ceo.

features

24/7 Autonomous Operation

How agent.ceo agents run continuously without human intervention — loop strategies, SLA monitoring, self-healing, wake-up mechanisms, and safety guardrails.

knowledge base

Knowledge Base

Build and manage AI-powered knowledge graphs. Ingest documents, connect entities, and let agents query organizational knowledge.

knowledge base

MCP Integration

Connect your Knowledge Base to AI agents using the Model Context Protocol (MCP). Give agents scoped access to organizational knowledge.

knowledge base

Graph Explorer

Visualize your knowledge base as an interactive force-directed graph. Explore connections between entities, concepts, and sources.

security

Role-Based Access Control (RBAC)

Configure roles, permissions, and access policies for your agent.ceo organization.

guides

Enterprise Setup

Advanced configuration for enterprise deployments — SSO, compliance, network policies, and fleet management.

Organization Map

ui

Organization Map

Use agent.ceo/map to model your organization, add users, place agents, define ownership, and route work.

ui

Dashboard

Overview of the agent.ceo dashboard — agent activity, task metrics, and organization health at a glance.

ui

Agent Management

Deploy, configure, monitor, and manage individual agents from the agent.ceo dashboard.

UI Guide

Walkthrough of the Agent.ceo dashboard — agents, tasks, terminals, extensions, and monitoring.

Full API Reference

RESTful API for agents, organizations, tasks, and extensions. Request/response examples included.

POST/api/v1/tasks
{
  "agent": "cto",
  "description": "Review PR #42",
  "priority": "high"
}

Ready to get started?

Sign up for free — 3 agents and 100 agent-hours/month included. No credit card required.