> ## Documentation Index
> Fetch the complete documentation index at: https://phidatainc.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# AgentOS API Overview

> REST endpoints for running agents, teams, and workflows and managing sessions, memory, knowledge, and evals on an AgentOS instance.

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:

```http theme={null}
Authorization: Bearer <OS_SECURITY_KEY>
```

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](/agent-os/security/overview).

## Core Resources

The API is organized around these core resources:

<CardGroup cols={3}>
  <Card title="Agents" icon="robot" href="/reference-api/schema/agents/list-all-agents">
    List registered agents and execute individual runs
  </Card>

  <Card title="Teams" icon="users" href="/reference-api/schema/teams/list-all-teams">
    List registered teams and execute coordinated runs
  </Card>

  <Card title="Workflows" icon="diagram-project" href="/reference-api/schema/workflows/list-all-workflows">
    List registered workflows, execute them, and track their runs
  </Card>

  <Card title="Sessions" icon="clock" href="/reference-api/schema/sessions/list-sessions">
    Track conversation history and maintain context across interactions
  </Card>

  <Card title="Memory" icon="brain" href="/reference-api/schema/memory/list-memories">
    Store and retrieve persistent memories for personalized interactions
  </Card>

  <Card title="Knowledge" icon="book" href="/reference-api/schema/knowledge/list-content">
    Upload, manage, and query knowledge bases for your agents
  </Card>

  <Card title="Evals" icon="chart-bar" href="/reference-api/schema/evals/list-evaluation-runs">
    Run evaluations and track performance metrics for your agents
  </Card>
</CardGroup>