# Agno: Reference

## Reference

### Agno SDK Reference

#### Agent

- [Agent](https://docs.agno.com/reference/agents/agent.md): Constructor parameters and methods for the Agent class.
- [RemoteAgent](https://docs.agno.com/reference/agents/remote-agent.md): Execute agents hosted on a remote AgentOS instance.

#### Team

- [Team](https://docs.agno.com/reference/teams/team.md): Constructor parameters and methods for the Team class.
- [RemoteTeam](https://docs.agno.com/reference/teams/remote-team.md): Execute teams hosted on a remote AgentOS instance.

#### Workflows

- [Workflow](https://docs.agno.com/reference/workflows/workflow.md): Constructor parameters and core execution, persistence, and session methods for the Workflow class.
- [RemoteWorkflow](https://docs.agno.com/reference/workflows/remote-workflow.md): Execute workflows hosted on a remote AgentOS or A2A server.
- [Step](https://docs.agno.com/reference/workflows/step.md): Constructor parameters for the workflow Step class, including retry and HITL options.
- [StepInput](https://docs.agno.com/reference/workflows/step_input.md): Fields and helper methods on the StepInput object passed to each workflow step.
- [StepOutput](https://docs.agno.com/reference/workflows/step_output.md): Fields returned by workflow step execution.
- [Conditional Steps](https://docs.agno.com/reference/workflows/conditional-steps.md): Constructor parameters for the workflow Condition class, which branches execution based on an evaluator.
- [Parallel Steps](https://docs.agno.com/reference/workflows/parallel-steps.md): Constructor parameters for the workflow Parallel class, which runs steps concurrently.
- [Router Steps](https://docs.agno.com/reference/workflows/router-steps.md): Constructor parameters for the workflow Router class, which dynamically selects steps to execute.
- [Loop Steps](https://docs.agno.com/reference/workflows/loop-steps.md): Parameter reference for the Loop step class, which repeats a sequence of steps until max_iterations or an end_condition is met.
- [Steps](https://docs.agno.com/reference/workflows/steps-step.md): Parameter reference for the Steps class, which groups a list of steps into a single sequential pipeline.

#### AgentOS

- [AgentOS](https://docs.agno.com/reference/agent-os/agent-os.md): Parameter and method reference for the AgentOS class that serves agents, teams, and workflows as a FastAPI app.
- [AgentOSConfig](https://docs.agno.com/reference/agent-os/configuration.md): Reference for AgentOSConfig, the YAML and Python schema for AgentOS UI, chat, and domain-page settings.
- [AuthorizationConfig](https://docs.agno.com/reference/agent-os/authorization-config.md): Parameter reference for AuthorizationConfig, which configures JWT verification for AgentOS RBAC authorization.
- [AuthMiddleware](https://docs.agno.com/reference/agent-os/jwt-middleware.md): Parameter reference for AuthMiddleware (aliased as JWTMiddleware), the AgentOS authentication and RBAC middleware.
- [Factories](https://docs.agno.com/reference/agent-os/factories.md): Registered callables that produce a fresh Agent, Team, or Workflow per request.

#### Clients

- [AgentOSClient](https://docs.agno.com/reference/clients/agentos-client.md): Python client for interacting with AgentOS API endpoints
- [A2AClient](https://docs.agno.com/reference/clients/a2a-client.md): Python client for communicating with A2A-compatible agent servers

#### Runs

- [RunOutput](https://docs.agno.com/reference/agents/run-response.md): Attributes of RunOutput and the events streamed during an agent run.
- [TeamRunOutput](https://docs.agno.com/reference/teams/team-response.md): Attributes of TeamRunOutput and the events streamed during a team run.
- [WorkflowRunOutput](https://docs.agno.com/reference/workflows/run-output.md): Attributes of WorkflowRunOutput, the events streamed during a workflow run, and workflow metrics.
- [RunContext](https://docs.agno.com/reference/run/run-context.md): Per-run state passed to hooks and tools: IDs, session state, dependencies, and resolved tools.
- [Metrics](https://docs.agno.com/reference/run/metrics.md): Token usage and timing for agent, team, and workflow runs, messages, sessions, and tool calls.

#### Reasoning

- [Reasoning Reference](https://docs.agno.com/reference/reasoning/reasoning.md): Data structures, toolkit parameters, and events shared by Reasoning Models, Reasoning Tools, and Reasoning Agents.

#### Sessions

- [SessionSummaryManager](https://docs.agno.com/reference/session/summary_manager.md): Attributes and methods of SessionSummaryManager, which generates session summaries with optional topic extraction.
- [AgentSession](https://docs.agno.com/reference/agents/session.md): Attributes and methods of AgentSession, the session object stored in the database for agent runs.
- [Team Session](https://docs.agno.com/reference/teams/session.md): Attributes and methods of TeamSession, the session object stored in the database for team runs.
- [WorkflowSession](https://docs.agno.com/reference/workflows/session.md): Attributes and methods of WorkflowSession, the session object stored in the database for workflow runs.

#### Memory

- [Memory Manager](https://docs.agno.com/reference/memory/memory.md): Create, search, update, and delete long-term user memories with MemoryManager.

#### Context Compression

- [CompressionManager](https://docs.agno.com/reference/compression/compression-manager.md): CompressionManager attributes and methods for compressing tool call results.

#### Database

- [PostgresDb](https://docs.agno.com/reference/storage/postgres.md): Store sessions, memories, metrics, knowledge, evals, and traces in PostgreSQL.
- [SqliteDb](https://docs.agno.com/reference/storage/sqlite.md): Store sessions, memories, metrics, knowledge, evals, and traces in SQLite.
- [MongoDb](https://docs.agno.com/reference/storage/mongodb.md): Store sessions, memories, metrics, knowledge, evals, and traces in MongoDB.
- [InMemoryDb](https://docs.agno.com/reference/storage/in_memory.md): Ephemeral in-process storage for sessions, memories, metrics, evals, and knowledge.
- [MySQLDb](https://docs.agno.com/reference/storage/mysql.md): Store AgentOS sessions, memory, knowledge, evals, and traces in MySQL.
- [RedisDb](https://docs.agno.com/reference/storage/redis.md): Store AgentOS sessions, memory, knowledge, evals, and traces in Redis.
- [ValkeyDb](https://docs.agno.com/reference/storage/valkey.md): ValkeyDb parameters for storing sessions and other AgentOS data in Valkey.
- [DynamoDb](https://docs.agno.com/reference/storage/dynamodb.md): Store AgentOS sessions, memory, knowledge, evals, and traces in Amazon DynamoDB.
- [SingleStoreDb](https://docs.agno.com/reference/storage/singlestore.md): Store AgentOS sessions, memory, knowledge, evals, and traces in SingleStore.
- [SurrealDb](https://docs.agno.com/reference/storage/surrealdb.md): Store AgentOS sessions, memory, knowledge, evals, and traces in SurrealDB.
- [FirestoreDb](https://docs.agno.com/reference/storage/firestore.md): Store AgentOS sessions, memory, knowledge, evals, and traces in Google Firestore.
- [JsonDb](https://docs.agno.com/reference/storage/json.md): Store sessions, memories, metrics, knowledge, evals, and traces in local JSON files.
- [GcsJsonDb](https://docs.agno.com/reference/storage/gcs.md): Store sessions, memories, metrics, knowledge, evals, and traces as JSON files in Google Cloud Storage.
- [MigrationManager](https://docs.agno.com/reference/storage/migrations.md): API reference for the MigrationManager class used to handle database migrations.

#### Media Storage

- [Local Media Storage](https://docs.agno.com/reference/media-storage/local.md): LocalMediaStorage stores agent media on the local filesystem.
- [S3 Media Storage](https://docs.agno.com/reference/media-storage/s3.md): S3MediaStorage stores agent media in an S3 bucket.
- [GCS Media Storage](https://docs.agno.com/reference/media-storage/gcs.md): GCSMediaStorage stores agent media in a Google Cloud Storage bucket.
- [MediaReference](https://docs.agno.com/reference/media-storage/media-reference.md): MediaReference is the pointer stored in the database in place of media bytes.

#### Tracing

- [Trace](https://docs.agno.com/reference/tracing/trace.md): Trace attributes, methods, and how to query stored traces from the database.
- [Span](https://docs.agno.com/reference/tracing/span.md): Span attributes, common span names, and OpenTelemetry attribute conventions.

#### Hooks

- [Pre-hooks](https://docs.agno.com/reference/hooks/pre-hooks.md): Parameters automatically injected into pre-hook functions during an Agent or Team run.
- [Post-hooks](https://docs.agno.com/reference/hooks/post-hooks.md): Parameters automatically injected into post-hook functions during an Agent or Team run.
- [@hook Decorator](https://docs.agno.com/reference/hooks/hook-decorator.md): Configure a hook to run as a non-blocking background task with @hook(run_in_background=True).

#### Guardrails

- [BaseGuardrail](https://docs.agno.com/reference/hooks/base-guardrail.md): Abstract base class for custom guardrails. Implement check and async_check to validate run input.
- [OpenAIModerationGuardrail](https://docs.agno.com/reference/hooks/openai-moderation-guardrail.md): Guardrail that flags or blocks input using OpenAI's moderation API.
- [PIIDetectionGuardrail](https://docs.agno.com/reference/hooks/pii-guardrail.md): Guardrail that detects and optionally masks PII such as SSNs, credit cards, emails, and phone numbers.
- [PromptInjectionGuardrail](https://docs.agno.com/reference/hooks/prompt-injection-guardrail.md): PromptInjectionGuardrail parameters and the default prompt injection patterns it checks for.

#### Evals

- [AccuracyEval](https://docs.agno.com/reference/evals/accuracy.md): AccuracyEval parameters, run methods, and AccuracyResult fields.
- [AgentAsJudgeEval](https://docs.agno.com/reference/evals/agent-as-judge.md): AgentAsJudgeEval parameters, binary and numeric scoring, and AgentAsJudgeResult fields.
- [PerformanceEval](https://docs.agno.com/reference/evals/performance.md): PerformanceEval parameters and PerformanceResult runtime and memory statistics.
- [ReliabilityEval](https://docs.agno.com/reference/evals/reliability.md): ReliabilityEval parameters, tool call and argument checks, and ReliabilityResult fields.
- [Eval Suite](https://docs.agno.com/reference/evals/suite.md): Case, CaseResult, JudgeMode, SuiteResult, the run_cases runners, and the cli exit code contract.

#### Models

- [Model](https://docs.agno.com/reference/models/model.md): Parameters on the base Model class shared by every Agno model provider, including caching and retry behavior.
- [OpenAI](https://docs.agno.com/reference/models/openai.md): Configure OpenAIChat, Agno's model class for OpenAI's Chat Completions API.
- [AI/ML API](https://docs.agno.com/reference/models/aimlapi.md): Configure models served through the AI/ML API OpenAI-compatible endpoint.
- [Ollama](https://docs.agno.com/reference/models/ollama.md): Configure the Ollama model class for local Ollama servers or Ollama Cloud.
- [Ollama Responses](https://docs.agno.com/reference/models/ollama-responses.md): Configure OllamaResponses, Agno's model class for Ollama's OpenAI-compatible Responses API.
- [Claude](https://docs.agno.com/reference/models/anthropic.md): Configure the Claude model class, Agno's wrapper for Anthropic's Messages API.
- [Cohere](https://docs.agno.com/reference/models/cohere.md): Parameter reference for the Cohere model class, covering request, client, and retry settings.
- [DeepInfra](https://docs.agno.com/reference/models/deepinfra.md): Parameter reference for the DeepInfra model class, which extends OpenAILike.
- [DeepSeek](https://docs.agno.com/reference/models/deepseek.md): Parameter reference for the DeepSeek model class, including thinking mode controls.
- [Gemini](https://docs.agno.com/reference/models/gemini.md): Parameter reference for the Gemini model class, covering Google AI Studio and Vertex AI configuration.
- [Groq](https://docs.agno.com/reference/models/groq.md): Parameter reference for the Groq model class, covering request and client settings.
- [HuggingFace](https://docs.agno.com/reference/models/huggingface.md): Parameter reference for the HuggingFace model class, covering Hugging Face Hub Inference settings.
- [Meta](https://docs.agno.com/reference/models/meta.md): Configure Llama, Agno's model class for Meta's Llama API.
- [Mistral](https://docs.agno.com/reference/models/mistral.md): Configure MistralChat, Agno's model class for Mistral's language models.
- [Nebius](https://docs.agno.com/reference/models/nebius.md): Configure Nebius, Agno's model class for Nebius Token Factory models.
- [N1N](https://docs.agno.com/reference/models/n1n.md): Access n1n.ai models through Agno's OpenAI-compatible N1N model class.
- [Nvidia](https://docs.agno.com/reference/models/nvidia.md): Configure Nvidia, Agno's model class for NVIDIA's language models.
- [Perplexity](https://docs.agno.com/reference/models/perplexity.md): Configure Perplexity, Agno's model class for Perplexity's language models.
- [Requesty](https://docs.agno.com/reference/models/requesty.md): Parameter reference for the Requesty model class, which extends OpenAILike to route requests through Requesty AI.
- [Together](https://docs.agno.com/reference/models/together.md): Parameter reference for the Together model class, which extends OpenAILike to connect to Together's language models.
- [xAI](https://docs.agno.com/reference/models/xai.md): Parameter reference for the xAI model class, which extends OpenAILike to connect to xAI's language models.
- [Vercel v0](https://docs.agno.com/reference/models/vercel.md): Parameter reference for the V0 model class, which extends OpenAILike to connect to Vercel's v0 API.
- [AWS Bedrock](https://docs.agno.com/reference/models/bedrock.md): Configuration reference for AwsBedrock, Agno's model class for models hosted on AWS Bedrock.
- [AWS Bedrock Claude](https://docs.agno.com/reference/models/bedrock-claude.md): Configuration reference for the Bedrock Claude model class, Agno's wrapper for Anthropic Claude models hosted on AWS Bedrock.
- [Azure AI Foundry](https://docs.agno.com/reference/models/azure.md): Configure AzureAIFoundry, Agno's model class for Azure AI Foundry-hosted models.
- [Azure OpenAI](https://docs.agno.com/reference/models/azure-open-ai.md): Configure AzureOpenAI, Agno's model class for Azure-hosted OpenAI models.
- [Fireworks](https://docs.agno.com/reference/models/fireworks.md): Configure Fireworks, Agno's model class for Fireworks-hosted language models.
- [OpenRouter](https://docs.agno.com/reference/models/openrouter.md): Configure OpenRouter, Agno's model class for unified access to language models via OpenRouter's Chat Completions API.
- [OpenRouter Responses](https://docs.agno.com/reference/models/openrouter-responses.md): Configure OpenRouterResponses, Agno's model class for OpenRouter's OpenAI-compatible Responses API.
- [SambaNova](https://docs.agno.com/reference/models/sambanova.md): Configure Sambanova, Agno's model class for SambaNova-hosted language models.
- [InternLM](https://docs.agno.com/reference/models/internlm.md): Configuration reference for InternLM, which extends OpenAILike to connect to InternLM's language models.
- [OpenAI Like](https://docs.agno.com/reference/models/openai-like.md): Configuration reference for OpenAILike, the base class for providers exposing an OpenAI-compatible Chat Completions API.
- [Open Responses](https://docs.agno.com/reference/models/open-responses.md): Configuration reference for OpenResponses, the base class for providers implementing the Open Responses API specification.
- [IBM WatsonX](https://docs.agno.com/reference/models/ibm-watsonx.md): Configuration reference for WatsonX, which connects to IBM's foundation models through the ibm-watsonx-ai client.

#### Tools

- [Tool Decorator](https://docs.agno.com/reference/tools/decorator.md): Reference for the @tool decorator.
- [Toolkit](https://docs.agno.com/reference/tools/toolkit.md): Reference for the Toolkit class.
- [RetryAgentRun](https://docs.agno.com/reference/tools/retry-agent-run.md): API reference for the RetryAgentRun exception used to provide feedback to the model within the tool call loop.
- [StopAgentRun](https://docs.agno.com/reference/tools/stop-agent-run.md): API reference for the StopAgentRun exception used to exit the tool call loop and complete the agent run.

#### Knowledge

- [Knowledge](https://docs.agno.com/reference/knowledge/knowledge.md): Parameter reference for the Knowledge class: vector database, contents database, readers, and search options.

##### Embedders

- [Azure OpenAI](https://docs.agno.com/reference/knowledge/embedder/azure-openai.md): Parameter reference for AzureOpenAIEmbedder: deployment, API version, endpoint, and batching options.
- [Cohere](https://docs.agno.com/reference/knowledge/embedder/cohere.md): Parameter reference for CohereEmbedder: model ID, input type, embedding types, and batching options.
- [FastEmbed](https://docs.agno.com/reference/knowledge/embedder/fastembed.md): Parameter reference for FastEmbedEmbedder. Defaults to the BAAI/bge-small-en-v1.5 model with 384 dimensions.
- [Fireworks](https://docs.agno.com/reference/knowledge/embedder/fireworks.md): Parameters for FireworksEmbedder, which embeds documents through Fireworks AI's OpenAI-compatible embeddings API.
- [Gemini](https://docs.agno.com/reference/knowledge/embedder/gemini.md): Parameters for GeminiEmbedder, which embeds documents with Gemini embedding models via the Gemini API or Vertex AI.
- [Hugging Face](https://docs.agno.com/reference/knowledge/embedder/huggingface.md): Parameters for HuggingfaceCustomEmbedder, which embeds documents through Hugging Face's InferenceClient.
- [Mistral](https://docs.agno.com/reference/knowledge/embedder/mistral.md): Parameters for MistralEmbedder, which embeds documents with Mistral AI embedding models.
- [Nebius](https://docs.agno.com/reference/knowledge/embedder/nebius.md): Parameters for NebiusEmbedder, an OpenAI-compatible embedder for Nebius Token Factory embedding models.
- [Ollama](https://docs.agno.com/reference/knowledge/embedder/ollama.md): Parameters for OllamaEmbedder, which embeds documents with models served by an Ollama instance.
- [OpenAI](https://docs.agno.com/reference/knowledge/embedder/openai.md): Parameter reference for OpenAIEmbedder, which embeds text with OpenAI's text-embedding-3 models.
- [Sentence Transformer](https://docs.agno.com/reference/knowledge/embedder/sentence-transformer.md): Parameter reference for SentenceTransformerEmbedder, which runs open-source sentence-transformers models locally.
- [Together](https://docs.agno.com/reference/knowledge/embedder/together.md): Parameter reference for TogetherEmbedder, an OpenAIEmbedder subclass pointed at Together AI's OpenAI-compatible API.
- [vLLM](https://docs.agno.com/reference/knowledge/embedder/vllm.md): Parameter reference for VLLMEmbedder, which embeds locally with a vLLM engine or remotely via an OpenAI-compatible server.
- [VoyageAI](https://docs.agno.com/reference/knowledge/embedder/voyageai.md): Parameter reference for VoyageAIEmbedder, which embeds text with VoyageAI embedding models via the voyageai client.

##### Readers

- [Reader](https://docs.agno.com/reference/knowledge/reader/base.md): Parameter reference for the Reader base class shared by all Agno readers.
- [Arxiv Reader](https://docs.agno.com/reference/knowledge/reader/arxiv.md): Parameters and methods of ArxivReader, which searches arXiv and reads paper summaries into documents.
- [CSV Reader](https://docs.agno.com/reference/knowledge/reader/csv.md): Parameters and methods of CSVReader, which reads CSV files into documents.
- [Field Labeled CSV Reader](https://docs.agno.com/reference/knowledge/reader/field-labeled-csv.md): Parameters and methods of FieldLabeledCSVReader, which converts each CSV row into a field-labeled document.
- [Docx Reader](https://docs.agno.com/reference/knowledge/reader/docx.md): Parameters and methods of DocxReader, which reads DOCX files into documents.
- [JSON Reader](https://docs.agno.com/reference/knowledge/reader/json.md): Parameters and methods of JSONReader, which reads JSON files into documents.
- [PDF Reader](https://docs.agno.com/reference/knowledge/reader/pdf.md): Parameters and methods of PDFReader, which reads PDF files into documents.
- [PPTX Reader](https://docs.agno.com/reference/knowledge/reader/pptx.md): Parameters and methods of PPTXReader, which reads PowerPoint (.pptx) files into documents.
- [Text Reader](https://docs.agno.com/reference/knowledge/reader/text.md): Parameters and methods of TextReader, which reads text files into documents.
- [Website Reader](https://docs.agno.com/reference/knowledge/reader/website.md): Parameters and methods of WebsiteReader, which crawls websites and reads pages into documents.
- [YouTube Reader](https://docs.agno.com/reference/knowledge/reader/youtube.md): Parameters and methods of YouTubeReader, which reads YouTube video transcripts into documents.
- [Firecrawl Reader](https://docs.agno.com/reference/knowledge/reader/firecrawl.md): Parameters and methods of FirecrawlReader, which scrapes or crawls websites into documents using Firecrawl.
- [Wikipedia Reader](https://docs.agno.com/reference/knowledge/reader/wikipedia.md): Parameters and methods of WikipediaReader, which reads Wikipedia article summaries into documents.
- [Web Search Reader](https://docs.agno.com/reference/knowledge/reader/web-search.md): WebSearchReader searches the web via DuckDuckGo and reads result pages into documents.

##### Rerankers

- [Cohere Reranker](https://docs.agno.com/reference/knowledge/reranker/cohere.md): CohereReranker reorders retrieved documents by relevance using Cohere rerank models.

##### Chunking

- [Fixed Size Chunking](https://docs.agno.com/reference/knowledge/chunking/fixed-size.md): Split documents into character-limited chunks with configurable overlap.
- [Agentic Chunking](https://docs.agno.com/reference/knowledge/chunking/agentic.md): AgenticChunking uses a model to pick natural breakpoints when splitting documents.
- [Semantic Chunking](https://docs.agno.com/reference/knowledge/chunking/semantic.md): SemanticChunking splits documents at semantic boundaries using embeddings via the Chonkie library.
- [Recursive Chunking](https://docs.agno.com/reference/knowledge/chunking/recursive.md): RecursiveChunking splits documents at natural break points like newlines and sentence endings.
- [Code Chunking](https://docs.agno.com/reference/knowledge/chunking/code.md): CodeChunking splits code at AST boundaries like functions and classes using the Chonkie library.
- [Document Chunking](https://docs.agno.com/reference/knowledge/chunking/document.md): DocumentChunking splits documents on structural boundaries like paragraphs and sections.
- [CSV Row Chunking](https://docs.agno.com/reference/knowledge/chunking/csv-row.md): RowChunking splits CSV files into one chunk per row.
- [Markdown Chunking](https://docs.agno.com/reference/knowledge/chunking/markdown.md): MarkdownChunking splits markdown on structure like headings, paragraphs, and sections.

##### Remote Content

- [GCS Content](https://docs.agno.com/reference/knowledge/remote-content/gcs-content.md): GCSContent adds content from a Google Cloud Storage bucket to your knowledge base.
- [S3 Content](https://docs.agno.com/reference/knowledge/remote-content/s3-content.md): S3Content adds content from an S3 bucket to your knowledge base.

### AgentOS API Reference

- [AgentOS API Overview](https://docs.agno.com/reference-api/overview.md): REST endpoints for running agents, teams, and workflows and managing sessions, memory, knowledge, and evals on an AgentOS instance.

#### Health

- [Health Check](https://docs.agno.com/reference-api/schema/health/health-check.md): Check the health status of the AgentOS API. Returns a simple status indicator.

#### Core

- [Get OS Info](https://docs.agno.com/reference-api/schema/core/get-os-info.md): Return lightweight, unauthenticated metadata about this AgentOS instance.
- [Get OS Configuration](https://docs.agno.com/reference-api/schema/core/get-os-configuration.md): Retrieve the complete configuration of the AgentOS instance, including:

#### Agents

- [List Agent Runs](https://docs.agno.com/reference-api/schema/agents/list-agent-runs.md): List runs for an agent within a session, optionally filtered by status.
- [Create Agent Run](https://docs.agno.com/reference-api/schema/agents/create-agent-run.md): Execute an agent with a message and optional media files. Supports both streaming and non-streaming responses.
- [Cancel Agent Run](https://docs.agno.com/reference-api/schema/agents/cancel-agent-run.md): Cancel a currently executing agent run. This will attempt to stop the agent's execution gracefully.
- [Continue Agent Run](https://docs.agno.com/reference-api/schema/agents/continue-agent-run.md): Advance a persisted agent run from its current state. Dispatches on the body shape and the persisted run state.
- [Fork Agent Session](https://docs.agno.com/reference-api/schema/agents/fork-agent-session.md): Deep-copy a session into a new independent session. Every run is copied with a fresh ``run_id``; the new session has a fresh ``session_id``. The original is untouched. Use to explore alternative conversation paths without mutating the source.
- [List All Agents](https://docs.agno.com/reference-api/schema/agents/list-all-agents.md): Retrieve a comprehensive list of all agents configured in this OS instance.
- [Get Agent Details](https://docs.agno.com/reference-api/schema/agents/get-agent-details.md): Retrieve detailed configuration and capabilities of a specific agent.
- [Get Agent Run](https://docs.agno.com/reference-api/schema/agents/get-agent-run.md): Retrieve the status and output of an agent run. Use this to poll for background run completion.
- [List Agent Run Checkpoints](https://docs.agno.com/reference-api/schema/agents/list-agent-run-checkpoints.md): List FE-friendly continuation boundaries derived from the current stored run. No separate checkpoint table is used; entries are inferred from message-level checkpoint markers and the terminal end of the transcript.
- [Get Agent Run Checkpoint Snapshot](https://docs.agno.com/reference-api/schema/agents/get-agent-run-checkpoint-snapshot.md): Return a derived run snapshot truncated at a message boundary. Use the returned message_index as `continue_from` when continuing this run.
- [Resume Agent Run Stream](https://docs.agno.com/reference-api/schema/agents/resume-agent-run-stream.md): Resume an SSE stream for an agent run after disconnection.

#### Teams

- [List Team Runs](https://docs.agno.com/reference-api/schema/teams/list-team-runs.md): List runs for a team within a session, optionally filtered by status.
- [Create Team Run](https://docs.agno.com/reference-api/schema/teams/create-team-run.md): Execute a team collaboration with multiple agents working together on a task.
- [Cancel Team Run](https://docs.agno.com/reference-api/schema/teams/cancel-team-run.md): Cancel a currently executing team run. This will attempt to stop the team's execution gracefully.
- [Resume Team Run Stream](https://docs.agno.com/reference-api/schema/teams/resume-team-run-stream.md): Resume an SSE stream for a team run after disconnection.
- [Continue Team Run](https://docs.agno.com/reference-api/schema/teams/continue-team-run.md): Continue a paused or incomplete team run with updated requirements.
- [Fork Team Session](https://docs.agno.com/reference-api/schema/teams/fork-team-session.md): Deep-copy a team session into a new independent session. Every run is copied with a fresh ``run_id``; the new session has a fresh ``session_id``. The original is untouched. Use to explore alternative conversation paths without mutating the source.
- [List Accessible Teams](https://docs.agno.com/reference-api/schema/teams/list-all-teams.md): Retrieve the teams visible to the authenticated principal. Administrators can access the complete roster. Scoped callers receive only teams allowed by their permissions.
- [Get Team Details](https://docs.agno.com/reference-api/schema/teams/get-team-details.md): Retrieve detailed configuration and member information for a specific team.
- [Get Team Run](https://docs.agno.com/reference-api/schema/teams/get-team-run.md): Retrieve the status and output of a team run. Use this to poll for background run completion.
- [List Team Run Checkpoints](https://docs.agno.com/reference-api/schema/teams/list-team-run-checkpoints.md): List FE-friendly continuation boundaries derived from the current stored team run. No separate checkpoint table is used; entries are inferred from message-level checkpoint markers and the terminal end of the transcript.
- [Get Team Run Checkpoint Snapshot](https://docs.agno.com/reference-api/schema/teams/get-team-run-checkpoint-snapshot.md): Return a derived team run snapshot truncated at a message boundary. Use the returned message_index as `continue_from` when continuing this run.

#### Workflows

- [List All Workflows](https://docs.agno.com/reference-api/schema/workflows/list-all-workflows.md): Retrieve summary records for the workflows configured in this AgentOS instance. Each item includes identifiers, metadata, database association, factory or component flags, and published stage or version fields when applicable. Use `GET /workflows/{workflow_id}` for input schemas, steps, agents, and…
- [Get Workflow Details](https://docs.agno.com/reference-api/schema/workflows/get-workflow-details.md): Retrieve detailed configuration and step information for a specific workflow.
- [Execute Workflow](https://docs.agno.com/reference-api/schema/workflows/execute-workflow.md): Execute a workflow with the provided input data. Workflows can run in streaming or batch mode.
- [List Workflow Runs](https://docs.agno.com/reference-api/schema/workflows/list-workflow-runs.md): List runs for a workflow within a session, optionally filtered by status.
- [Continue Workflow Run](https://docs.agno.com/reference-api/schema/workflows/continue-workflow-run.md): Continue a paused workflow run with resolved requirements.
- [Cancel Workflow Run](https://docs.agno.com/reference-api/schema/workflows/cancel-workflow-run.md): Cancel a currently executing workflow run, stopping all active steps and cleanup. **Note:** Complex workflows with multiple parallel steps may take time to fully cancel.
- [Resume Workflow Run Stream](https://docs.agno.com/reference-api/schema/workflows/resume-workflow-run-stream.md): Resume an SSE stream for a workflow run after disconnection.
- [Get Workflow Run](https://docs.agno.com/reference-api/schema/workflows/get-workflow-run.md): Retrieve the status and output of a workflow run. Use this to poll for run completion.

#### Slack

- [Slack Events](https://docs.agno.com/reference-api/schema/slack/slack-events.md): Receives incoming Slack events (messages, mentions, thread starts).
- [Slack Interactions](https://docs.agno.com/reference-api/schema/slack/slack-interactions.md): Handles Slack interactive components for Human-in-the-Loop (HITL) workflows.

#### Telegram

- [Telegram Status](https://docs.agno.com/reference-api/schema/telegram/status.md)
- [Telegram Webhook](https://docs.agno.com/reference-api/schema/telegram/webhook.md)

#### Whatsapp

- [Status](https://docs.agno.com/reference-api/schema/whatsapp/status.md)
- [Whatsapp Verify](https://docs.agno.com/reference-api/schema/whatsapp/verify-webhook.md): Handle WhatsApp webhook verification
- [Whatsapp Webhook](https://docs.agno.com/reference-api/schema/whatsapp/webhook.md): Process incoming WhatsApp messages

#### AGUI

- [Run Agent](https://docs.agno.com/reference-api/schema/agui/run-agent.md)
- [Get Status](https://docs.agno.com/reference-api/schema/agui/get-status.md)

#### A2A

- [Get Agent Card](https://docs.agno.com/reference-api/schema/a2a/get-agent-card.md)
- [Run Message Agent](https://docs.agno.com/reference-api/schema/a2a/run-message-agent.md): Send a message to an Agno Agent (non-streaming). The Agent is identified via the path parameter '{id}'. Optional: Pass user ID via X-User-ID header (recommended) or 'userId' in params.message.metadata.
- [Get Agent Task](https://docs.agno.com/reference-api/schema/a2a/get-agent-task.md): Get the status and result of an agent task by ID.
- [Cancel Agent Task](https://docs.agno.com/reference-api/schema/a2a/cancel-agent-task.md): Cancel a running agent task.
- [Stream Message Agent](https://docs.agno.com/reference-api/schema/a2a/stream-message-agent.md): Stream a message to an Agno Agent (streaming). The Agent is identified via the path parameter '{id}'. Optional: Pass user ID via X-User-ID header (recommended) or 'userId' in params.message.metadata. Returns real-time updates as server-sent events (SSE).
- [Get Team Card](https://docs.agno.com/reference-api/schema/a2a/get-team-card.md)
- [Run Message Team](https://docs.agno.com/reference-api/schema/a2a/run-message-team.md): Send a message to an Agno Team (non-streaming). The Team is identified via the path parameter '{id}'. Optional: Pass user ID via X-User-ID header (recommended) or 'userId' in params.message.metadata.
- [Get Team Task](https://docs.agno.com/reference-api/schema/a2a/get-team-task.md): Get the status and result of a team task by ID.
- [Cancel Team Task](https://docs.agno.com/reference-api/schema/a2a/cancel-team-task.md): Cancel a running team task.
- [Stream Message Team](https://docs.agno.com/reference-api/schema/a2a/stream-message-team.md): Stream a message to an Agno Team (streaming). The Team is identified via the path parameter '{id}'. Optional: Pass user ID via X-User-ID header (recommended) or 'userId' in params.message.metadata. Returns real-time updates as server-sent events (SSE).
- [Get Workflow Card](https://docs.agno.com/reference-api/schema/a2a/get-workflow-card.md)
- [Run Message Workflow](https://docs.agno.com/reference-api/schema/a2a/run-message-workflow.md): Send a message to an Agno Workflow (non-streaming). The Workflow is identified via the path parameter '{id}'. Optional: Pass user ID via X-User-ID header (recommended) or 'userId' in params.message.metadata.
- [Stream Message Workflow](https://docs.agno.com/reference-api/schema/a2a/stream-message-workflow.md): Stream a message to an Agno Workflow (streaming). The Workflow is identified via the path parameter '{id}'. Optional: Pass user ID via X-User-ID header (recommended) or 'userId' in params.message.metadata. Returns real-time updates as server-sent events (SSE).

#### Sessions

- [List Sessions](https://docs.agno.com/reference-api/schema/sessions/list-sessions.md): Retrieve paginated list of sessions with filtering and sorting options. Supports filtering by session type (agent, team, workflow), component, user, and name. Sessions represent conversation histories and execution contexts.
- [Create New Session](https://docs.agno.com/reference-api/schema/sessions/create-new-session.md): Create a new empty session with optional configuration. Useful for pre-creating sessions with specific session_state, metadata, or other properties before running any agent/team/workflow interactions. The session can later be used by providing its session_id in run requests.
- [Delete Multiple Sessions](https://docs.agno.com/reference-api/schema/sessions/delete-multiple-sessions.md): Delete multiple sessions by their IDs in a single operation. This action cannot be undone and will permanently remove all specified sessions and their runs.
- [Get Session by ID](https://docs.agno.com/reference-api/schema/sessions/get-session-by-id.md): Retrieve detailed information about a specific session including metadata, configuration, and run history. Response schema varies based on session type (agent, team, or workflow).
- [Delete Session](https://docs.agno.com/reference-api/schema/sessions/delete-session.md): Permanently delete a specific session and all its associated runs. This action cannot be undone and will remove all conversation history.
- [Update Session](https://docs.agno.com/reference-api/schema/sessions/update-session.md): Update session properties such as session_name, session_state, metadata, or summary. Use this endpoint to modify the session name, update state, add metadata, or update the session summary.
- [Get Session Runs](https://docs.agno.com/reference-api/schema/sessions/get-session-runs.md): Retrieve all runs (executions) for a specific session with optional timestamp filtering. Runs represent individual interactions or executions within a session. Response schema varies based on session type.
- [Get Run by ID](https://docs.agno.com/reference-api/schema/sessions/get-run-by-id.md): Retrieve a specific run by its ID from a session. Response schema varies based on the run type (agent run, team run, or workflow run).
- [Rename Session](https://docs.agno.com/reference-api/schema/sessions/rename-session.md): Update the name of an existing session. Useful for organizing and categorizing sessions with meaningful names for better identification and management.

#### Media

- [Fetch stored media for a session](https://docs.agno.com/reference-api/schema/media/fetch-stored-media-for-a-session.md): Stream (or, with redirect=true, redirect to a freshly-signed URL for) a piece of media stored in external media storage. Scoped to the caller's session ownership; the storage_key must belong to the session.

#### Memory

- [List Memories](https://docs.agno.com/reference-api/schema/memory/list-memories.md): Retrieve paginated list of user memories with filtering and search capabilities. Filter by user, agent, team, topics, or search within memory content.
- [Create Memory](https://docs.agno.com/reference-api/schema/memory/create-memory.md): Create a new user memory with content and associated topics. Memories are used to store contextual information for users across conversations.
- [Delete Multiple Memories](https://docs.agno.com/reference-api/schema/memory/delete-multiple-memories.md): Delete multiple user memories by their IDs in a single operation. This action cannot be undone and all specified memories will be permanently removed.
- [Get Memory by ID](https://docs.agno.com/reference-api/schema/memory/get-memory-by-id.md): Retrieve detailed information about a specific user memory by its ID.
- [Delete Memory](https://docs.agno.com/reference-api/schema/memory/delete-memory.md): Delete a specific user memory. A valid local database request returns 204 even when no memory matches the ID.
- [Update Memory](https://docs.agno.com/reference-api/schema/memory/update-memory.md): Update an existing user memory's content and topics. Replaces the entire memory content and topic list with the provided values.
- [Get Memory Topics](https://docs.agno.com/reference-api/schema/memory/get-memory-topics.md): Retrieve all unique topics associated with memories in the system. Useful for filtering and categorizing memories by topic.
- [Get User Memory Statistics](https://docs.agno.com/reference-api/schema/memory/get-user-memory-statistics.md): Retrieve paginated statistics about memory usage by user. Provides insights into user engagement and memory distribution across users.
- [Optimize User Memories](https://docs.agno.com/reference-api/schema/memory/optimize-user-memories.md): Optimize all memories for a given user using the default summarize strategy. This operation combines all memories into a single comprehensive summary, achieving maximum token reduction while preserving all key information. To use a custom model, specify the model parameter in 'provider:model_id' for…

#### Learnings

- [List Learnings](https://docs.agno.com/reference-api/schema/learnings/list-learnings.md): List learning records with pagination and optional filters. For a scoped (non-admin) caller with user isolation enabled, results are bound to that user and also include records with no owner (`user_id IS NULL`) — this covers global, agent, team, session, and entity-scoped learnings; passing a `user_…
- [Create Learning](https://docs.agno.com/reference-api/schema/learnings/create-learning.md): Create a new learning record. For the identity-keyed learning types (`user_profile`, `user_memory`, `session_context`, `entity_memory`) the record id is derived deterministically from the identity fields so it reconciles with what the agent reads/writes — provide those fields (else 422), and if a re…
- [List Learning Users](https://docs.agno.com/reference-api/schema/learnings/list-learning-users.md): List the users that own learning records, with a per-user count and last-updated timestamp. Intended as the entry point for a per-user view: list users here, then drill into a single user's learnings via `GET /learnings?user_id=...`. Records with no owner (`user_id IS NULL`) are excluded. Pass `lear…
- [Delete Learning User](https://docs.agno.com/reference-api/schema/learnings/delete-learning-user.md): Delete the learning records owned by a user. By default removes every learning type backed by the agno_learnings table (user_profile, user_memory, and any user-scoped entity records); pass `learning_type` to restrict deletion to a single store. Records with no owner (`user_id IS NULL`) are not affec…
- [Get Learning](https://docs.agno.com/reference-api/schema/learnings/get-learning.md): Retrieve a single learning record by its ID.
- [Update Learning](https://docs.agno.com/reference-api/schema/learnings/update-learning.md): Update a learning record. Only `content` and `metadata` may be modified; identity fields (user_id, agent_id, team_id, etc.) are immutable. Provided fields fully replace the existing values. Records with no owner (`user_id IS NULL` — shared agent/team/session/entity learnings) are readable by any cal…
- [Delete Learning](https://docs.agno.com/reference-api/schema/learnings/delete-learning.md): Permanently delete a learning record by its ID. Records with no owner (`user_id IS NULL` — shared agent/team/session/entity learnings) may only be deleted by an admin.

#### Evals

- [List Evaluation Runs](https://docs.agno.com/reference-api/schema/evals/list-evaluation-runs.md): Retrieve paginated evaluation runs with filtering and sorting options. Filter by agent, team, workflow, model, or evaluation type.
- [Execute Evaluation](https://docs.agno.com/reference-api/schema/evals/execute-evaluation.md): Run evaluation tests on agents or teams. Supports accuracy, agent-as-judge, performance, and reliability evaluations. Requires either agent_id or team_id, but not both.
- [Delete Evaluation Runs](https://docs.agno.com/reference-api/schema/evals/delete-evaluation-runs.md): Delete multiple evaluation runs by their IDs. This action cannot be undone.
- [Get Evaluation Run](https://docs.agno.com/reference-api/schema/evals/get-evaluation-run.md): Retrieve detailed results and metrics for a specific evaluation run.
- [Update Evaluation Run](https://docs.agno.com/reference-api/schema/evals/update-evaluation-run.md): Update the name or other properties of an existing evaluation run.

#### Metrics

- [Get AgentOS Metrics](https://docs.agno.com/reference-api/schema/metrics/get-agentos-metrics.md): Retrieve AgentOS metrics and analytics data for a specified date range. If no date range is specified, returns all available metrics.
- [Refresh Metrics](https://docs.agno.com/reference-api/schema/metrics/refresh-metrics.md): Manually trigger recalculation of system metrics from raw data. This operation analyzes system activity logs and regenerates aggregated metrics. Useful for ensuring metrics are up-to-date or after system maintenance. By default the refresh runs synchronously and returns the refreshed metrics. Pass b…
- [Get Metrics Refresh Status](https://docs.agno.com/reference-api/schema/metrics/get-metrics-refresh-status.md): Get the status of the most recent metrics refresh for the target database. Returns 'running' while a refresh is in progress, then 'completed' or 'failed' with the finish timestamp — the state updates even when a refresh completes without writing new data. Returns 'idle' if no refresh has been trigge…

#### Knowledge

- [List Content](https://docs.agno.com/reference-api/schema/knowledge/list-content.md): Retrieve paginated list of all content in the knowledge base with filtering and sorting options. Filter by status, content type, or metadata properties.
- [Upload Content](https://docs.agno.com/reference-api/schema/knowledge/upload-content.md): Upload content to the knowledge base. Supports file uploads, text content, or URLs. Content is processed asynchronously in the background. Supports custom readers and chunking strategies.
- [Delete All Content](https://docs.agno.com/reference-api/schema/knowledge/delete-all-content.md): Permanently remove content from the knowledge base. With user isolation enabled, a non-admin caller removes only its own content; shared and other users' content remain. Admins and unscoped callers remove all content. This action cannot be undone.
- [Upload Remote Content](https://docs.agno.com/reference-api/schema/knowledge/upload-remote-content.md): Upload content from a remote source (S3, GCS, SharePoint, GitHub) to the knowledge base. Content is processed asynchronously in the background.
- [List Content Sources](https://docs.agno.com/reference-api/schema/knowledge/list-content-sources.md): List all registered content sources (S3, GCS, SharePoint, GitHub) for the knowledge base.
- [List Files in Source](https://docs.agno.com/reference-api/schema/knowledge/list-files-in-source.md): List available files and folders in a specific content source. Supports pagination and folder navigation.
- [Get Content by ID](https://docs.agno.com/reference-api/schema/knowledge/get-content-by-id.md): Retrieve detailed information about a specific content item including processing status and metadata.
- [Delete Content by ID](https://docs.agno.com/reference-api/schema/knowledge/delete-content-by-id.md): Permanently remove a specific content item from the knowledge base. With user isolation enabled, a non-admin caller can delete its own content but cannot delete shared content. Content outside the caller's scope is reported as not found. This action cannot be undone.
- [Update Content](https://docs.agno.com/reference-api/schema/knowledge/update-content.md): Update content properties such as name, description, metadata, or processing configuration. Allows modification of existing content without re-uploading.
- [Refresh Content](https://docs.agno.com/reference-api/schema/knowledge/refresh-content.md): Re-ingest a URL- or path-sourced content row from its source. For a site row this refreshes changed pages, retries failed ones, and removes pages that left the site.
- [Get Content Status](https://docs.agno.com/reference-api/schema/knowledge/get-content-status.md): Retrieve the current processing status of a content item. Useful for monitoring asynchronous content processing progress and identifying any processing errors.
- [Search Knowledge](https://docs.agno.com/reference-api/schema/knowledge/search-knowledge.md): Search the knowledge base for relevant documents using query, filters and search type.
- [Get Config](https://docs.agno.com/reference-api/schema/knowledge/get-config.md): Retrieve available readers, chunkers, and configuration options for content processing. This endpoint provides metadata about supported file types, processing strategies, and filters.

#### Traces

- [List Traces](https://docs.agno.com/reference-api/schema/traces/list-traces.md): Retrieve a paginated list of execution traces with optional filtering.
- [Get Trace Filter Schema](https://docs.agno.com/reference-api/schema/traces/get-trace-filter-schema.md): Returns the available filterable fields, their types, valid operators, and enum values.
- [Get Trace or Span Detail](https://docs.agno.com/reference-api/schema/traces/get-trace-or-span-detail.md): Retrieve detailed trace information with hierarchical span tree, or a specific span within the trace.
- [Get Trace Statistics by Session](https://docs.agno.com/reference-api/schema/traces/get-trace-statistics-by-session.md): Retrieve aggregated trace statistics grouped by session ID with pagination.
- [Search Traces with Advanced Filters](https://docs.agno.com/reference-api/schema/traces/search-traces-with-advanced-filters.md): Search traces using the FilterExpr DSL for complex, composable queries.

#### Database

- [Migrate All Databases](https://docs.agno.com/reference-api/schema/database/migrate-all-databases.md): Migrate all database schemas to the given target version. If a target version is not provided, all databases will be migrated to the latest version.
- [Migrate Database](https://docs.agno.com/reference-api/schema/database/migrate-database.md): Migrate the given database schema to the given target version. If a target version is not provided, the database will be migrated to the latest version.

#### Components

- [List Components](https://docs.agno.com/reference-api/schema/components/list-components.md): Retrieve a paginated list of components with optional filtering by type.
- [Create Component](https://docs.agno.com/reference-api/schema/components/create-component.md): Create a new component (agent, team, or workflow) with initial config.
- [Get Component](https://docs.agno.com/reference-api/schema/components/get-component.md): Retrieve a component by ID.
- [Delete Component](https://docs.agno.com/reference-api/schema/components/delete-component.md): Soft-delete a component by ID. Component configs and links remain stored.
- [Restore Component](https://docs.agno.com/reference-api/schema/components/restore-component.md): Restore an archived (soft-deleted) component by ID.
- [Update Component](https://docs.agno.com/reference-api/schema/components/update-component.md): Partially update a component by ID.
- [List Configs](https://docs.agno.com/reference-api/schema/components/list-configs.md): List all configs for a component.
- [Create Config Version](https://docs.agno.com/reference-api/schema/components/create-config-version.md): Create a new config version for a component.
- [Get Config Version](https://docs.agno.com/reference-api/schema/components/get-config-version.md): Get a specific config version by number.
- [Delete Config Version](https://docs.agno.com/reference-api/schema/components/delete-config-version.md): Delete a specific draft config version. Cannot delete published or current configs.
- [Update Draft Config](https://docs.agno.com/reference-api/schema/components/update-draft-config.md): Update an existing draft config. Cannot update published configs.
- [Get Current Config](https://docs.agno.com/reference-api/schema/components/get-current-config.md): Get the current config version for a component.
- [Set Current Config Version](https://docs.agno.com/reference-api/schema/components/set-current-config-version.md): Set a published config version as current (for rollback).

#### Registry

- [List Registry](https://docs.agno.com/reference-api/schema/registry/list-registry.md): List all resources in the registry with optional filtering.

#### Schedules

- [List Schedules](https://docs.agno.com/reference-api/schema/schedules/list-schedules.md)
- [Create Schedule](https://docs.agno.com/reference-api/schema/schedules/create-schedule.md)
- [Get Schedule](https://docs.agno.com/reference-api/schema/schedules/get-schedule.md)
- [Delete Schedule](https://docs.agno.com/reference-api/schema/schedules/delete-schedule.md)
- [Update Schedule](https://docs.agno.com/reference-api/schema/schedules/update-schedule.md)
- [Enable Schedule](https://docs.agno.com/reference-api/schema/schedules/enable-schedule.md): Enable a schedule after verifying access to its target and confirming that the target is published, active, and still matches the schedule endpoint.
- [Disable Schedule](https://docs.agno.com/reference-api/schema/schedules/disable-schedule.md)
- [Trigger Schedule](https://docs.agno.com/reference-api/schema/schedules/trigger-schedule.md)
- [List Schedule Runs](https://docs.agno.com/reference-api/schema/schedules/list-schedule-runs.md)
- [Get Schedule Run](https://docs.agno.com/reference-api/schema/schedules/get-schedule-run.md)

#### Approvals

- [List Approvals](https://docs.agno.com/reference-api/schema/approvals/list-approvals.md)
- [Get Approval Count](https://docs.agno.com/reference-api/schema/approvals/get-approval-count.md)
- [Get Approval](https://docs.agno.com/reference-api/schema/approvals/get-approval.md)
- [Get Approval Status](https://docs.agno.com/reference-api/schema/approvals/get-approval-status.md)
- [Delete Approval](https://docs.agno.com/reference-api/schema/approvals/delete-approval.md): Delete an approval audit record. Scoped non-admin callers receive 404 so approval existence is not disclosed.
- [Resolve Approval](https://docs.agno.com/reference-api/schema/approvals/resolve-approval.md)

#### Queue

- [Queue Stats](https://docs.agno.com/reference-api/schema/queue/get-queue-stats.md): Job counts by status and the oldest queued job's age - the queue-health signals to alert on.
- [List Queue Jobs](https://docs.agno.com/reference-api/schema/queue/list-queue-jobs.md): List job queue jobs, optionally filtered by status. Repeat the status param to match any of several (e.g. status=failed&status=cancelled for the requeueable set; status=failed alone is the dead-letter list). Useful sort_by fields: created_at (default), updated_at, completed_at, status, attempt, comp…
- [Get Queue Job](https://docs.agno.com/reference-api/schema/queue/get-queue-job.md)
- [Requeue Failed Queue Job](https://docs.agno.com/reference-api/schema/queue/requeue-queue-job.md): Requeue a terminally failed or cancelled job for one more execution (raises its attempt budget by one). The operator remedy for crashed runs under the no-silent-re-execution default. Requeueing a CANCELLED job whose cancellation intent is still live requires clear_cancellation=true - an explicit ove…

#### Service Accounts

- [Create Service Account](https://docs.agno.com/reference-api/schema/service-accounts/create-service-account.md): Mint a service account token. The plaintext token is returned exactly once.
- [List Service Accounts](https://docs.agno.com/reference-api/schema/service-accounts/list-service-accounts.md): List service accounts. Returns metadata and display prefixes only - never hashes or plaintext.
- [Revoke Service Account](https://docs.agno.com/reference-api/schema/service-accounts/revoke-service-account.md): Revoke a service account. Idempotent.

#### Health

- [Health Check](https://docs.agno.com/api-reference/health/health-check.md): Check the health status of the AgentOS API. Returns a simple status indicator.

#### Core

- [Get OS Info](https://docs.agno.com/api-reference/core/get-os-info.md): Return lightweight, unauthenticated metadata about this AgentOS instance.
- [Get OS Configuration](https://docs.agno.com/api-reference/core/get-os-configuration.md): Retrieve the complete configuration of the AgentOS instance, including:

#### Agents

- [List Agent Runs](https://docs.agno.com/api-reference/agents/list-agent-runs.md): List runs for an agent within a session, optionally filtered by status.
- [Create Agent Run](https://docs.agno.com/api-reference/agents/create-agent-run.md): Execute an agent with a message and optional media files. Supports both streaming and non-streaming responses.
- [Cancel Agent Run](https://docs.agno.com/api-reference/agents/cancel-agent-run.md): Cancel a currently executing agent run. This will attempt to stop the agent's execution gracefully.
- [Continue Agent Run](https://docs.agno.com/api-reference/agents/continue-agent-run.md): Advance a persisted agent run from its current state. Dispatches on the body shape and the persisted run state.
- [Fork Agent Session](https://docs.agno.com/api-reference/agents/fork-agent-session.md): Deep-copy a session into a new independent session. Every run is copied with a fresh ``run_id``; the new session has a fresh ``session_id``. The original is untouched. Use to explore alternative conversation paths without mutating the source.
- [List All Agents](https://docs.agno.com/api-reference/agents/list-all-agents.md): Retrieve a comprehensive list of all agents configured in this OS instance.
- [Get Agent Details](https://docs.agno.com/api-reference/agents/get-agent-details.md): Retrieve detailed configuration and capabilities of a specific agent.
- [Get Agent Run](https://docs.agno.com/api-reference/agents/get-agent-run.md): Retrieve the status and output of an agent run. Use this to poll for background run completion.
- [List Agent Run Checkpoints](https://docs.agno.com/api-reference/agents/list-agent-run-checkpoints.md): List FE-friendly continuation boundaries derived from the current stored run. No separate checkpoint table is used; entries are inferred from message-level checkpoint markers and the terminal end of the transcript.
- [Get Agent Run Checkpoint Snapshot](https://docs.agno.com/api-reference/agents/get-agent-run-checkpoint-snapshot.md): Return a derived run snapshot truncated at a message boundary. Use the returned message_index as `continue_from` when continuing this run.
- [Resume Agent Run Stream](https://docs.agno.com/api-reference/agents/resume-agent-run-stream.md): Resume an SSE stream for an agent run after disconnection.

#### Teams

- [List Team Runs](https://docs.agno.com/api-reference/teams/list-team-runs.md): List runs for a team within a session, optionally filtered by status.
- [Create Team Run](https://docs.agno.com/api-reference/teams/create-team-run.md): Execute a team collaboration with multiple agents working together on a task.
- [Cancel Team Run](https://docs.agno.com/api-reference/teams/cancel-team-run.md): Cancel a currently executing team run. This will attempt to stop the team's execution gracefully.
- [Resume Team Run Stream](https://docs.agno.com/api-reference/teams/resume-team-run-stream.md): Resume an SSE stream for a team run after disconnection.
- [Continue Team Run](https://docs.agno.com/api-reference/teams/continue-team-run.md): Continue a paused or incomplete team run with updated requirements.
- [Fork Team Session](https://docs.agno.com/api-reference/teams/fork-team-session.md): Deep-copy a team session into a new independent session. Every run is copied with a fresh ``run_id``; the new session has a fresh ``session_id``. The original is untouched. Use to explore alternative conversation paths without mutating the source.
- [List Accessible Teams](https://docs.agno.com/api-reference/teams/list-accessible-teams.md): Retrieve the teams visible to the authenticated principal. Administrators can access the complete roster. Scoped callers receive only teams allowed by their permissions.
- [Get Team Details](https://docs.agno.com/api-reference/teams/get-team-details.md): Retrieve detailed configuration and member information for a specific team.
- [Get Team Run](https://docs.agno.com/api-reference/teams/get-team-run.md): Retrieve the status and output of a team run. Use this to poll for background run completion.
- [List Team Run Checkpoints](https://docs.agno.com/api-reference/teams/list-team-run-checkpoints.md): List FE-friendly continuation boundaries derived from the current stored team run. No separate checkpoint table is used; entries are inferred from message-level checkpoint markers and the terminal end of the transcript.
- [Get Team Run Checkpoint Snapshot](https://docs.agno.com/api-reference/teams/get-team-run-checkpoint-snapshot.md): Return a derived team run snapshot truncated at a message boundary. Use the returned message_index as `continue_from` when continuing this run.

#### Workflows

- [List All Workflows](https://docs.agno.com/api-reference/workflows/list-all-workflows.md): Retrieve summary records for the workflows configured in this AgentOS instance. Each item includes identifiers, metadata, database association, factory or component flags, and published stage or version fields when applicable. Use `GET /workflows/{workflow_id}` for input schemas, steps, agents, and…
- [Get Workflow Details](https://docs.agno.com/api-reference/workflows/get-workflow-details.md): Retrieve detailed configuration and step information for a specific workflow.
- [List Workflow Runs](https://docs.agno.com/api-reference/workflows/list-workflow-runs.md): List runs for a workflow within a session, optionally filtered by status.
- [Execute Workflow](https://docs.agno.com/api-reference/workflows/execute-workflow.md): Execute a workflow with the provided input data. Workflows can run in streaming or batch mode.
- [Continue Workflow Run](https://docs.agno.com/api-reference/workflows/continue-workflow-run.md): Continue a paused workflow run with resolved requirements.
- [Cancel Workflow Run](https://docs.agno.com/api-reference/workflows/cancel-workflow-run.md): Cancel a currently executing workflow run, stopping all active steps and cleanup. **Note:** Complex workflows with multiple parallel steps may take time to fully cancel.
- [Resume Workflow Run Stream](https://docs.agno.com/api-reference/workflows/resume-workflow-run-stream.md): Resume an SSE stream for a workflow run after disconnection.
- [Get Workflow Run](https://docs.agno.com/api-reference/workflows/get-workflow-run.md): Retrieve the status and output of a workflow run. Use this to poll for run completion.

#### Queue

- [List Queue Jobs](https://docs.agno.com/api-reference/queue/list-queue-jobs.md): List job queue jobs, optionally filtered by status. Repeat the status param to match any of several (e.g. status=failed&status=cancelled for the requeueable set; status=failed alone is the dead-letter list). Useful sort_by fields: created_at (default), updated_at, completed_at, status, attempt, comp…
- [Get Queue Job](https://docs.agno.com/api-reference/queue/get-queue-job.md)
- [Requeue Failed Queue Job](https://docs.agno.com/api-reference/queue/requeue-failed-queue-job.md): Requeue a terminally failed or cancelled job for one more execution (raises its attempt budget by one). The operator remedy for crashed runs under the no-silent-re-execution default. Requeueing a CANCELLED job whose cancellation intent is still live requires clear_cancellation=true - an explicit ove…
- [Queue Stats](https://docs.agno.com/api-reference/queue/queue-stats.md): Job counts by status and the oldest queued job's age - the queue-health signals to alert on.

#### Slack

- [Slack Events](https://docs.agno.com/api-reference/slack/slack-events.md): Receives incoming Slack events (messages, mentions, thread starts).
- [Slack Interactions](https://docs.agno.com/api-reference/slack/slack-interactions.md): Handles Slack interactive components for Human-in-the-Loop (HITL) workflows.

#### Whatsapp

- [Status](https://docs.agno.com/api-reference/whatsapp/status.md)
- [Whatsapp Verify](https://docs.agno.com/api-reference/whatsapp/whatsapp-verify.md): Handle WhatsApp webhook verification
- [Whatsapp Webhook](https://docs.agno.com/api-reference/whatsapp/whatsapp-webhook.md): Process incoming WhatsApp messages

#### Telegram

- [Telegram Status](https://docs.agno.com/api-reference/telegram/telegram-status.md)
- [Telegram Webhook](https://docs.agno.com/api-reference/telegram/telegram-webhook.md)

#### AGUI

- [Run Agent](https://docs.agno.com/api-reference/agui/run-agent.md)
- [Get Status](https://docs.agno.com/api-reference/agui/get-status.md)

#### A2A

- [Get Agent Card](https://docs.agno.com/api-reference/a2a/get-agent-card.md)
- [Run Message Agent](https://docs.agno.com/api-reference/a2a/run-message-agent.md): Send a message to an Agno Agent (non-streaming). The Agent is identified via the path parameter '{id}'. Optional: Pass user ID via X-User-ID header (recommended) or 'userId' in params.message.metadata.
- [Get Agent Task](https://docs.agno.com/api-reference/a2a/get-agent-task.md): Get the status and result of an agent task by ID.
- [Cancel Agent Task](https://docs.agno.com/api-reference/a2a/cancel-agent-task.md): Cancel a running agent task.
- [Stream Message Agent](https://docs.agno.com/api-reference/a2a/stream-message-agent.md): Stream a message to an Agno Agent (streaming). The Agent is identified via the path parameter '{id}'. Optional: Pass user ID via X-User-ID header (recommended) or 'userId' in params.message.metadata. Returns real-time updates as server-sent events (SSE).
- [Get Team Card](https://docs.agno.com/api-reference/a2a/get-team-card.md)
- [Run Message Team](https://docs.agno.com/api-reference/a2a/run-message-team.md): Send a message to an Agno Team (non-streaming). The Team is identified via the path parameter '{id}'. Optional: Pass user ID via X-User-ID header (recommended) or 'userId' in params.message.metadata.
- [Get Team Task](https://docs.agno.com/api-reference/a2a/get-team-task.md): Get the status and result of a team task by ID.
- [Cancel Team Task](https://docs.agno.com/api-reference/a2a/cancel-team-task.md): Cancel a running team task.
- [Stream Message Team](https://docs.agno.com/api-reference/a2a/stream-message-team.md): Stream a message to an Agno Team (streaming). The Team is identified via the path parameter '{id}'. Optional: Pass user ID via X-User-ID header (recommended) or 'userId' in params.message.metadata. Returns real-time updates as server-sent events (SSE).
- [Get Workflow Card](https://docs.agno.com/api-reference/a2a/get-workflow-card.md)
- [Run Message Workflow](https://docs.agno.com/api-reference/a2a/run-message-workflow.md): Send a message to an Agno Workflow (non-streaming). The Workflow is identified via the path parameter '{id}'. Optional: Pass user ID via X-User-ID header (recommended) or 'userId' in params.message.metadata.
- [Stream Message Workflow](https://docs.agno.com/api-reference/a2a/stream-message-workflow.md): Stream a message to an Agno Workflow (streaming). The Workflow is identified via the path parameter '{id}'. Optional: Pass user ID via X-User-ID header (recommended) or 'userId' in params.message.metadata. Returns real-time updates as server-sent events (SSE).

#### Sessions

- [List Sessions](https://docs.agno.com/api-reference/sessions/list-sessions.md): Retrieve paginated list of sessions with filtering and sorting options. Supports filtering by session type (agent, team, workflow), component, user, and name. Sessions represent conversation histories and execution contexts.
- [Create New Session](https://docs.agno.com/api-reference/sessions/create-new-session.md): Create a new empty session with optional configuration. Useful for pre-creating sessions with specific session_state, metadata, or other properties before running any agent/team/workflow interactions. The session can later be used by providing its session_id in run requests.
- [Delete Multiple Sessions](https://docs.agno.com/api-reference/sessions/delete-multiple-sessions.md): Delete multiple sessions by their IDs in a single operation. This action cannot be undone and will permanently remove all specified sessions and their runs.
- [Get Session by ID](https://docs.agno.com/api-reference/sessions/get-session-by-id.md): Retrieve detailed information about a specific session including metadata, configuration, and run history. Response schema varies based on session type (agent, team, or workflow).
- [Delete Session](https://docs.agno.com/api-reference/sessions/delete-session.md): Permanently delete a specific session and all its associated runs. This action cannot be undone and will remove all conversation history.
- [Update Session](https://docs.agno.com/api-reference/sessions/update-session.md): Update session properties such as session_name, session_state, metadata, or summary. Use this endpoint to modify the session name, update state, add metadata, or update the session summary.
- [Get Session Runs](https://docs.agno.com/api-reference/sessions/get-session-runs.md): Retrieve all runs (executions) for a specific session with optional timestamp filtering. Runs represent individual interactions or executions within a session. Response schema varies based on session type.
- [Get Run by ID](https://docs.agno.com/api-reference/sessions/get-run-by-id.md): Retrieve a specific run by its ID from a session. Response schema varies based on the run type (agent run, team run, or workflow run).
- [Rename Session](https://docs.agno.com/api-reference/sessions/rename-session.md): Update the name of an existing session. Useful for organizing and categorizing sessions with meaningful names for better identification and management.

#### Media

- [Fetch stored media for a session](https://docs.agno.com/api-reference/media/fetch-stored-media-for-a-session.md): Stream (or, with redirect=true, redirect to a freshly-signed URL for) a piece of media stored in external media storage. Scoped to the caller's session ownership; the storage_key must belong to the session.

#### Memory

- [List Memories](https://docs.agno.com/api-reference/memory/list-memories.md): Retrieve paginated list of user memories with filtering and search capabilities. Filter by user, agent, team, topics, or search within memory content.
- [Create Memory](https://docs.agno.com/api-reference/memory/create-memory.md): Create a new user memory with content and associated topics. Memories are used to store contextual information for users across conversations.
- [Delete Multiple Memories](https://docs.agno.com/api-reference/memory/delete-multiple-memories.md): Delete multiple user memories by their IDs in a single operation. This action cannot be undone and all specified memories will be permanently removed.
- [Get Memory by ID](https://docs.agno.com/api-reference/memory/get-memory-by-id.md): Retrieve detailed information about a specific user memory by its ID.
- [Delete Memory](https://docs.agno.com/api-reference/memory/delete-memory.md): Delete a specific user memory. A valid local database request returns 204 even when no memory matches the ID.
- [Update Memory](https://docs.agno.com/api-reference/memory/update-memory.md): Update an existing user memory's content and topics. Replaces the entire memory content and topic list with the provided values.
- [Get Memory Topics](https://docs.agno.com/api-reference/memory/get-memory-topics.md): Retrieve all unique topics associated with memories in the system. Useful for filtering and categorizing memories by topic.
- [Get User Memory Statistics](https://docs.agno.com/api-reference/memory/get-user-memory-statistics.md): Retrieve paginated statistics about memory usage by user. Provides insights into user engagement and memory distribution across users.
- [Optimize User Memories](https://docs.agno.com/api-reference/memory/optimize-user-memories.md): Optimize all memories for a given user using the default summarize strategy. This operation combines all memories into a single comprehensive summary, achieving maximum token reduction while preserving all key information. To use a custom model, specify the model parameter in 'provider:model_id' for…

#### Learnings

- [List Learnings](https://docs.agno.com/api-reference/learnings/list-learnings.md): List learning records with pagination and optional filters. For a scoped (non-admin) caller with user isolation enabled, results are bound to that user and also include records with no owner (`user_id IS NULL`) — this covers global, agent, team, session, and entity-scoped learnings; passing a `user_…
- [Create Learning](https://docs.agno.com/api-reference/learnings/create-learning.md): Create a new learning record. For the identity-keyed learning types (`user_profile`, `user_memory`, `session_context`, `entity_memory`) the record id is derived deterministically from the identity fields so it reconciles with what the agent reads/writes — provide those fields (else 422), and if a re…
- [List Learning Users](https://docs.agno.com/api-reference/learnings/list-learning-users.md): List the users that own learning records, with a per-user count and last-updated timestamp. Intended as the entry point for a per-user view: list users here, then drill into a single user's learnings via `GET /learnings?user_id=...`. Records with no owner (`user_id IS NULL`) are excluded. Pass `lear…
- [Delete Learning User](https://docs.agno.com/api-reference/learnings/delete-learning-user.md): Delete the learning records owned by a user. By default removes every learning type backed by the agno_learnings table (user_profile, user_memory, and any user-scoped entity records); pass `learning_type` to restrict deletion to a single store. Records with no owner (`user_id IS NULL`) are not affec…
- [Get Learning](https://docs.agno.com/api-reference/learnings/get-learning.md): Retrieve a single learning record by its ID.
- [Delete Learning](https://docs.agno.com/api-reference/learnings/delete-learning.md): Permanently delete a learning record by its ID. Records with no owner (`user_id IS NULL` — shared agent/team/session/entity learnings) may only be deleted by an admin.
- [Update Learning](https://docs.agno.com/api-reference/learnings/update-learning.md): Update a learning record. Only `content` and `metadata` may be modified; identity fields (user_id, agent_id, team_id, etc.) are immutable. Provided fields fully replace the existing values. Records with no owner (`user_id IS NULL` — shared agent/team/session/entity learnings) are readable by any cal…

#### Evals

- [List Evaluation Runs](https://docs.agno.com/api-reference/evals/list-evaluation-runs.md): Retrieve paginated evaluation runs with filtering and sorting options. Filter by agent, team, workflow, model, or evaluation type.
- [Execute Evaluation](https://docs.agno.com/api-reference/evals/execute-evaluation.md): Run evaluation tests on agents or teams. Supports accuracy, agent-as-judge, performance, and reliability evaluations. Requires either agent_id or team_id, but not both.
- [Delete Evaluation Runs](https://docs.agno.com/api-reference/evals/delete-evaluation-runs.md): Delete multiple evaluation runs by their IDs. This action cannot be undone.
- [Get Evaluation Run](https://docs.agno.com/api-reference/evals/get-evaluation-run.md): Retrieve detailed results and metrics for a specific evaluation run.
- [Update Evaluation Run](https://docs.agno.com/api-reference/evals/update-evaluation-run.md): Update the name or other properties of an existing evaluation run.

#### Metrics

- [Get AgentOS Metrics](https://docs.agno.com/api-reference/metrics/get-agentos-metrics.md): Retrieve AgentOS metrics and analytics data for a specified date range. If no date range is specified, returns all available metrics.
- [Refresh Metrics](https://docs.agno.com/api-reference/metrics/refresh-metrics.md): Manually trigger recalculation of system metrics from raw data. This operation analyzes system activity logs and regenerates aggregated metrics. Useful for ensuring metrics are up-to-date or after system maintenance. By default the refresh runs synchronously and returns the refreshed metrics. Pass b…
- [Get Metrics Refresh Status](https://docs.agno.com/api-reference/metrics/get-metrics-refresh-status.md): Get the status of the most recent metrics refresh for the target database. Returns 'running' while a refresh is in progress, then 'completed' or 'failed' with the finish timestamp — the state updates even when a refresh completes without writing new data. Returns 'idle' if no refresh has been trigge…

#### Knowledge

- [List Content](https://docs.agno.com/api-reference/knowledge/list-content.md): Retrieve paginated list of all content in the knowledge base with filtering and sorting options. Filter by status, content type, or metadata properties.
- [Upload Content](https://docs.agno.com/api-reference/knowledge/upload-content.md): Upload content to the knowledge base. Supports file uploads, text content, or URLs. Content is processed asynchronously in the background. Supports custom readers and chunking strategies.
- [Delete All Content](https://docs.agno.com/api-reference/knowledge/delete-all-content.md): Permanently remove content from the knowledge base. With user isolation enabled, a non-admin caller removes only its own content; shared and other users' content remain. Admins and unscoped callers remove all content. This action cannot be undone.
- [Upload Remote Content](https://docs.agno.com/api-reference/knowledge/upload-remote-content.md): Upload content from a remote source (S3, GCS, SharePoint, GitHub) to the knowledge base. Content is processed asynchronously in the background.
- [Get Content by ID](https://docs.agno.com/api-reference/knowledge/get-content-by-id.md): Retrieve detailed information about a specific content item including processing status and metadata.
- [Delete Content by ID](https://docs.agno.com/api-reference/knowledge/delete-content-by-id.md): Permanently remove a specific content item from the knowledge base. With user isolation enabled, a non-admin caller can delete its own content but cannot delete shared content. Content outside the caller's scope is reported as not found. This action cannot be undone.
- [Update Content](https://docs.agno.com/api-reference/knowledge/update-content.md): Update content properties such as name, description, metadata, or processing configuration. Allows modification of existing content without re-uploading.
- [Refresh Content](https://docs.agno.com/api-reference/knowledge/refresh-content.md): Re-ingest a URL- or path-sourced content row from its source. For a site row this refreshes changed pages, retries failed ones, and removes pages that left the site.
- [Get Content Status](https://docs.agno.com/api-reference/knowledge/get-content-status.md): Retrieve the current processing status of a content item. Useful for monitoring asynchronous content processing progress and identifying any processing errors.
- [Search Knowledge](https://docs.agno.com/api-reference/knowledge/search-knowledge.md): Search the knowledge base for relevant documents using query, filters and search type.
- [Get Config](https://docs.agno.com/api-reference/knowledge/get-config.md): Retrieve available readers, chunkers, and configuration options for content processing. This endpoint provides metadata about supported file types, processing strategies, and filters.
- [List Content Sources](https://docs.agno.com/api-reference/knowledge/list-content-sources.md): List all registered content sources (S3, GCS, SharePoint, GitHub) for the knowledge base.
- [List Files in Source](https://docs.agno.com/api-reference/knowledge/list-files-in-source.md): List available files and folders in a specific content source. Supports pagination and folder navigation.

#### Traces

- [List Traces](https://docs.agno.com/api-reference/traces/list-traces.md): Retrieve a paginated list of execution traces with optional filtering.
- [Get Trace Filter Schema](https://docs.agno.com/api-reference/traces/get-trace-filter-schema.md): Returns the available filterable fields, their types, valid operators, and enum values.
- [Get Trace or Span Detail](https://docs.agno.com/api-reference/traces/get-trace-or-span-detail.md): Retrieve detailed trace information with hierarchical span tree, or a specific span within the trace.
- [Get Trace Statistics by Session](https://docs.agno.com/api-reference/traces/get-trace-statistics-by-session.md): Retrieve aggregated trace statistics grouped by session ID with pagination.
- [Search Traces with Advanced Filters](https://docs.agno.com/api-reference/traces/search-traces-with-advanced-filters.md): Search traces using the FilterExpr DSL for complex, composable queries.

#### Database

- [Migrate All Databases](https://docs.agno.com/api-reference/database/migrate-all-databases.md): Migrate all database schemas to the given target version. If a target version is not provided, all databases will be migrated to the latest version.
- [Migrate Database](https://docs.agno.com/api-reference/database/migrate-database.md): Migrate the given database schema to the given target version. If a target version is not provided, the database will be migrated to the latest version.

#### Components

- [List Components](https://docs.agno.com/api-reference/components/list-components.md): Retrieve a paginated list of components with optional filtering by type.
- [Create Component](https://docs.agno.com/api-reference/components/create-component.md): Create a new component (agent, team, or workflow) with initial config.
- [Get Component](https://docs.agno.com/api-reference/components/get-component.md): Retrieve a component by ID.
- [Delete Component](https://docs.agno.com/api-reference/components/delete-component.md): Soft-delete a component by ID. Component configs and links remain stored.
- [Update Component](https://docs.agno.com/api-reference/components/update-component.md): Partially update a component by ID.
- [Restore Component](https://docs.agno.com/api-reference/components/restore-component.md): Restore an archived (soft-deleted) component by ID.
- [List Configs](https://docs.agno.com/api-reference/components/list-configs.md): List all configs for a component.
- [Create Config Version](https://docs.agno.com/api-reference/components/create-config-version.md): Create a new config version for a component.
- [Get Config Version](https://docs.agno.com/api-reference/components/get-config-version.md): Get a specific config version by number.
- [Delete Config Version](https://docs.agno.com/api-reference/components/delete-config-version.md): Delete a specific draft config version. Cannot delete published or current configs.
- [Update Draft Config](https://docs.agno.com/api-reference/components/update-draft-config.md): Update an existing draft config. Cannot update published configs.
- [Get Current Config](https://docs.agno.com/api-reference/components/get-current-config.md): Get the current config version for a component.
- [Set Current Config Version](https://docs.agno.com/api-reference/components/set-current-config-version.md): Set a published config version as current (for rollback).

#### Schedules

- [List Schedules](https://docs.agno.com/api-reference/schedules/list-schedules.md)
- [Create Schedule](https://docs.agno.com/api-reference/schedules/create-schedule.md)
- [Get Schedule](https://docs.agno.com/api-reference/schedules/get-schedule.md)
- [Delete Schedule](https://docs.agno.com/api-reference/schedules/delete-schedule.md)
- [Update Schedule](https://docs.agno.com/api-reference/schedules/update-schedule.md)
- [Enable Schedule](https://docs.agno.com/api-reference/schedules/enable-schedule.md): Enable a schedule after verifying access to its target and confirming that the target is published, active, and still matches the schedule endpoint.
- [Disable Schedule](https://docs.agno.com/api-reference/schedules/disable-schedule.md)
- [Trigger Schedule](https://docs.agno.com/api-reference/schedules/trigger-schedule.md)
- [List Schedule Runs](https://docs.agno.com/api-reference/schedules/list-schedule-runs.md)
- [Get Schedule Run](https://docs.agno.com/api-reference/schedules/get-schedule-run.md)

#### Approvals

- [List Approvals](https://docs.agno.com/api-reference/approvals/list-approvals.md)
- [Get Approval Count](https://docs.agno.com/api-reference/approvals/get-approval-count.md)
- [Get Approval Status](https://docs.agno.com/api-reference/approvals/get-approval-status.md)
- [Get Approval](https://docs.agno.com/api-reference/approvals/get-approval.md)
- [Delete Approval](https://docs.agno.com/api-reference/approvals/delete-approval.md): Delete an approval audit record. Scoped non-admin callers receive 404 so approval existence is not disclosed.
- [Resolve Approval](https://docs.agno.com/api-reference/approvals/resolve-approval.md)

#### Service Accounts

- [List Service Accounts](https://docs.agno.com/api-reference/service-accounts/list-service-accounts.md): List service accounts. Returns metadata and display prefixes only - never hashes or plaintext.
- [Create Service Account](https://docs.agno.com/api-reference/service-accounts/create-service-account.md): Mint a service account token. The plaintext token is returned exactly once.
- [Revoke Service Account](https://docs.agno.com/api-reference/service-accounts/revoke-service-account.md): Revoke a service account. Idempotent.

#### Registry

- [List Registry](https://docs.agno.com/api-reference/registry/list-registry.md): List all resources in the registry with optional filtering.

### Agno CLI

- [Agno CLI](https://docs.agno.com/reference/cli/agnoctl.md): Flags, environment variables, exit codes, and JSON output contracts for every agno CLI command.

### Agno Infra CLI

- [ag infra create](https://docs.agno.com/reference/agno-infra/cli/ws/create.md): Options for ag infra create: scaffold a new AgentOS codebase from a starter template.
- [ag infra up](https://docs.agno.com/reference/agno-infra/cli/ws/up.md): Options for ag infra up: create resources for the active AgentOS codebase, filtered by env, infra, group, name, or type.
- [ag infra down](https://docs.agno.com/reference/agno-infra/cli/ws/down.md): Options for ag infra down: delete resources for the active AgentOS codebase, filtered by env, infra, group, name, or type.
- [ag infra restart](https://docs.agno.com/reference/agno-infra/cli/ws/restart.md): Options for ag infra restart: run ag infra down, wait 2 seconds, then ag infra up for the active AgentOS codebase.
- [ag infra patch](https://docs.agno.com/reference/agno-infra/cli/ws/patch.md): Options for ag infra patch: update resources for the active AgentOS codebase, filtered by env, infra, group, name, or type.
- [ag infra config](https://docs.agno.com/reference/agno-infra/cli/ws/config.md): Prints infra_name and infra_root_path for the active AgentOS codebase.
- [ag infra delete](https://docs.agno.com/reference/agno-infra/cli/ws/delete.md): Deletes the AgentOS codebase record from Agno config without removing any files.

## OpenAPI Specs

- [openapi](/reference-api/openapi.yaml)