> ## Documentation Index > Fetch the complete documentation index at: https://docs.trugen.ai/llms.txt > Use this file to discover all available pages before exploring further. # List All Agents > Fetches a list of all your agents, including associated avatars, knowledge bases, and callback settings. ## OpenAPI ````yaml GET /ext/agent openapi: 3.0.3 info: title: TruGen Developer Platform API version: 1.0.0 description: OpenAPI specification for MCP endpoint servers: - url: https://api.trugen.ai/v1 security: [] paths: /ext/agent: get: summary: Retrieve all Agents description: >- Fetches a list of all your agents, including associated avatars, knowledge bases, and callback settings. operationId: getAllAgents parameters: - name: offset in: query required: false description: The number of agents to skip before starting to return results. schema: type: integer default: 0 - name: perpage in: query required: false description: The number of agents to return per page. schema: type: integer default: 10 - name: search in: query required: false description: Search criteria to filter agents by name or ID. schema: type: string responses: '200': description: List of agents retrieved successfully headers: X-Total-Count: schema: type: integer description: Total number of agents matching the query. content: application/json: schema: type: array items: type: object properties: id: type: string format: uuid description: Unique identifier for the agent. example: b63c2a53-266b-4b43-a71b-7ea8b5e2e916 agent_name: type: string description: Display name of the agent. example: Customer Support Agent agent_system_prompt: type: string description: Foundational system instruction used by this agent. example: >- You are a helpful AI assistant that handles customer service inquiries. avatars: type: array description: List of avatars associated with this agent. items: type: object properties: avatar_key_id: type: string description: Avatar identifier key. example: avatar_001 persona_name: type: string description: Display name for the avatar persona. example: Sofia - Friendly Support persona_prompt: type: string description: >- Behavioral prompt for the avatar interaction style. example: >- Speak in a warm, engaging tone and provide clear answers. config: type: object description: >- Configuration for avatar behavior and runtime settings. properties: llm: type: object description: >- Large Language Model settings used by the avatar. properties: model: type: string description: Identifier of the LLM model. example: >- meta-llama/llama-4-maverick-17b-128e-instruct provider: type: string description: Provider used for LLM inference. example: groq stt: type: object description: Speech-to-Text model configuration. properties: model: type: string description: Speech recognition model identifier. example: flux-general-en provider: type: string description: STT provider service name. example: deepgram min_endpointing_delay: type: number description: Minimum endpointing delay in seconds. example: 0.3 max_endpointing_delay: type: number description: Maximum endpointing delay in seconds. example: 0.4 tts: type: object description: Text-to-Speech generation configuration. properties: model_id: type: string description: Voice synthesis model identifier. example: eleven_turbo_v2_5 provider: type: string description: TTS provider service name. example: elevenlabs voice_id: type: string description: Voice ID used to synthesize speech. example: ZUrEGyu8GFMwnHbvLhv2 callback_events: type: array description: Webhook events that should trigger callbacks. items: type: string example: utterance_committed example: - participant_left - agent.started_speaking - agent.stopped_speaking - agent.interrupted - user.started_speaking - user.stopped_speaking - utterance_committed - max_call_duration_timeout callback_url: type: string description: Webhook endpoint URL to send callback events to. example: https://webhooks.example.com/agent-events config: type: object description: Agent-level configuration properties. properties: systemPrompt: type: string description: System prompt value stored within config. example: >- Always respond with a concise solution first, then provide optional detail. maxCallDuration: type: integer description: Maximum call duration allowed in seconds. example: 1800 conversationalContext: type: string description: >- Context label used to maintain continuity across sessions. example: customer-support knowledge_base: type: array description: List of knowledge bases attached to this agent. nullable: true items: type: object properties: id: type: string format: uuid description: Knowledge base identifier. example: ac79226e-73e1-41fe-8cde-469ae4e244fa name: type: string description: Name of the knowledge base. example: Product Support Articles description: type: string description: Short summary of the knowledge base content. example: >- Contains FAQs and troubleshooting guides for product lines. tool: type: array description: List of tools attached to this agent. nullable: true items: type: object properties: id: type: string format: uuid description: Tool identifier. example: ac79226e-73e1-41fe-8cde-469ae4e244fa name: type: string description: Name of the tool. example: Product Support Articles description: type: string description: Short summary of the tool's functionality. example: Tool for accessing employee directory. mcp: type: array description: List of MCP attached to this agent. nullable: true items: type: object properties: id: type: string format: uuid description: MCP identifier. example: ac79226e-73e1-41fe-8cde-469ae4e244fa name: type: string description: Name of the MCP. example: Product Support Articles description: type: string description: Short summary of the MCP's functionality. example: MCP for accessing employee directory. record: type: boolean description: >- Determines whether voice call recordings should be stored. example: true created_at: type: string format: date-time description: Timestamp indicating when the agent was created. example: '2025-12-01T10:20:30.000Z' updated_at: type: string format: date-time description: Last updated timestamp for the agent. example: '2025-12-03T14:50:00.000Z' example: - id: 045302f0-9783-4ff2-846e-3888fb2a7894 agent_name: HR Assistant agent_system_prompt: You are an HR Assistant. avatars: - avatar_key_id: 1e4ea106 persona_name: Lisa config: llm: model: meta-llama/llama-4-maverick-17b-128e-instruct provider: groq stt: model: flux-general-en provider: deepgram min_endpointing_delay: 0.3 max_endpointing_delay: 0.4 tts: model_id: eleven_turbo_v2_5 provider: elevenlabs voice_id: ZUrEGyu8GFMwnHbvLhv2 callback_events: - utterance_committed callback_url: '' config: maxCallDuration: 10 conversationalContext: >- You are going to speak with employees from our Machine Learning Team. knowledge_base: null mcp: null tool: null record: true created_at: '2025-10-17T19:05:25.557061Z' updated_at: '2025-10-17T19:05:25.557061Z' '401': description: Unauthorized – missing or invalid API key content: application/json: schema: type: object properties: error: type: string example: error: 'Unauthorized: not a valid authorization api key' '500': description: Internal server error content: application/json: schema: type: object properties: error: type: string example: error: Failed to retrieve agent details security: - apiKeyAuth: [] components: securitySchemes: apiKeyAuth: type: apiKey in: header name: x-api-key ````