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

# List Agents

> List the agents this key can use, newest first.

## Overview

Lists the agents you own plus agents other people [shared with you](https://docs.memanto.ai/cloud/console/people.md), newest first.

## Authentication

**x-api-key** `string` *required*

Your Memanto Cloud API key (`mk_...`). See [Authentication](https://docs.memanto.ai/cloud/api/introduction.md#authentication).

## Query Parameters

**include\_counts** `boolean` (default: true)

Count each agent's memories live. Pass `false` for a faster response that uses the stored count.

```bash cURL theme={null}
curl -X GET "https://api.memanto.ai/agents" \
  -H "x-api-key: $MEMANTO_API_KEY"
```

```json 200 - OK theme={null}
{
  "agents": [
    {
      "agent_id": "my-agent",
      "pattern": "tool",
      "description": "Coding assistant memory",
      "created_at": "2026-11-19T15:04:05.000Z",
      "status": "ready",
      "memory_count": 42
    }
  ],
  "count": 1,
  "warnings": []
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.