> ## 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.

# Get Agent

> Get one agent and its memory count.

## Overview

Returns one agent you own or that was shared with you. Returns `404` if it doesn't exist or you can't use it.

## Authentication

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

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

## Path Parameters

**agent\_id** `string` *required*

The agent's ID.

## Query Parameters

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

Count the agent's memories live.

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

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


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