Skip to main content
The AgentOS API is a REST API for your running AgentOS instance. Use it to run agents, teams, and workflows, and to manage sessions, memory, knowledge, and evals from your own applications.

​
Authentication

AgentOS runs in one of three authentication modes: JWT, Security Key, or none. When the OS_SECURITY_KEY environment variable is set on the server and no JWT source is configured, API requests must send the key as a bearer token:
JWT configuration takes precedence over the security key and adds per-endpoint permissions. When neither is configured, authentication is disabled for that instance. See Security & Auth.

​
Core Resources

The API is organized around these core resources:

Agents

List registered agents and execute individual runs

Teams

List registered teams and execute coordinated runs

Workflows

List registered workflows, execute them, and track their runs

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