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

# List Agents

Retrieve all agent configurations for the authenticated user. This endpoint returns a list of all agents you have access to, including their metadata and configuration details.

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET https://api.artaios.ai/api/v1/agent/ \
    -H "x-api-key: YOUR_API_KEY"
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://api.artaios.ai/api/v1/agent/",
      headers={"x-api-key": "YOUR_API_KEY"}
  )
  agents = response.json()
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://api.artaios.ai/api/v1/agent/', {
    headers: {
      'x-api-key': 'YOUR_API_KEY'
    }
  });
  const agents = await response.json();
  ```
</CodeGroup>

## Response

Returns an array of agent configuration objects:

```json theme={null}
[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "agent_key": "customer_support_agent",
    "name": "Customer Support Agent",
    "architecture": "llm_agent",
    "entry_point": "main",
    "is_public": false,
    "is_shared": false,
    "origin_url": null,
    "owner": "user_123",
    "company": "company_456",
    "system_config": {
      "name": "Customer Support Agent",
      "agent_type": "llm_agent",
      "system_prompt": "You are a helpful customer support agent...",
      "llm_config": {
        "model": "gpt-4o",
        "temperature": 0.7
      }
    },
    "version_number": "1.0.0",
    "config_hash": "a1b2c3d4e5f6",
    "created_at": "2025-01-15T10:30:00Z",
    "updated_at": "2025-01-15T10:30:00Z"
  }
]
```

<Note>
  **Key Response Fields:**

  * `agent_key` - Unique identifier derived from agent name
  * `architecture` - Agent architecture type (e.g., `llm_agent`, `react_agent`)
  * `system_config` - Complete agent configuration including prompts, LLM settings, tools, and knowledge bases
  * `version_number` - Current version of the agent configuration
  * `config_hash` - Hash of the current configuration for change detection
</Note>