AgentOS API Overview
Complete API reference for interacting with AgentOS programmatically
Welcome to the comprehensive API reference for the Kern AgentOS API. This RESTful API enables you to programmatically interact with your AgentOS instance, manage agents, teams, and workflows, and integrate AgentOS capabilities into your applications.
Authentication
AgentOS supports bearer-token authentication via a single Security Key.
- When
OS_SECURITY_KEYenvironment variable is set on the server, all routes require:
1Authorization: Bearer <OS_SECURITY_KEY>- When
OS_SECURITY_KEYis not set, authentication is disabled for that instance.
See the dedicated guide: Secure your AgentOS with a Security Key.
Core Resources
The AgentOS API is organized around several key resources:
Agents
Create, manage, and execute individual agent runs with tools and knowledge
Teams
Orchestrate multiple agents working together on complex tasks
Workflows
Define and execute multi-step automated processes
Sessions
Track conversation history and maintain context across interactions
Memory
Store and retrieve persistent memories for personalized interactions
Knowledge
Upload, manage, and query knowledge bases for your agents
Evals
Run evaluations and track performance metrics for your agents