Welcome to the comprehensive API reference for the Agno 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_KEY environment variable is set on the server, all routes require:
Authorization: Bearer <OS_SECURITY_KEY>
  • When OS_SECURITY_KEY is 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