List All Agents

What discovery returns

The response describes the visible runtime configuration. It combines served code agents with visible database components; served code IDs take precedence. Authorization can filter the list.

Factories return their declared metadata without being invoked. External framework adapters can return minimal metadata, and registry-only entries used for rehydration are not a separate inventory. Do not treat discovery as a complete serialization of every constructor, prompt or tool configuration.

GET/agents

Retrieve a comprehensive list of all agents configured in this OS instance.

Returns:

  • Agent metadata (ID, name, description)
  • Model configuration and capabilities
  • Available tools and their configurations
  • Session, knowledge, memory, and reasoning settings
  • Only meaningful (non-default) configurations are included

Authorization

HTTPBearer
AuthorizationBearer <token>

In: header

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl --request GET 'https://example.com/agents'
[  {    "id": "main-agent",    "name": "Main Agent",    "db_id": "c6bf0644-feb8-4930-a305-380dae5ad6aa",    "model": {      "name": "OpenAIChat",      "model": "gpt-4o",      "provider": "OpenAI"    },    "sessions": {      "session_table": "agno_sessions"    },    "knowledge": {      "knowledge_table": "main_knowledge"    },    "system_message": {      "markdown": true,      "add_datetime_to_context": true    }  }]