---
title: "🔒 #25987 Список записей памяти агентов с фильтрами и статистикой использования. Администратору - все записи компании, кроме чужой памяти уровня пользователя; сотруднику - свои записи и общие проверенные в пределах доступных проектов."
method: GET
path: "/agent-memory/list"
tags: ["AgentMemory"]
---

# 🔒 #25987 Список записей памяти агентов с фильтрами и статистикой использования. Администратору - все записи компании, кроме чужой памяти уровня пользователя; сотруднику - свои записи и общие проверенные в пределах доступных проектов.

`GET /agent-memory/list`

## Request

- Base URL: `http://localhost`
- URL: `http://localhost/agent-memory/list`
- Auth: one of:
  - API key in header `sid` and API key in header `rts` and API key in header `sig`
  - HTTP bearer

#25987 Список записей памяти агентов с фильтрами и статистикой использования. Администратору - все записи компании, кроме чужой памяти уровня пользователя; сотруднику - свои записи и общие проверенные в пределах доступных проектов.

**Access:** `authorized` (10 ) · **Scope:** `read`

**Allows:** `memory:write`, `memory:moderate` (все обязательны; проверка в команде по ресурсу из запроса)

### TypeScript (copy-paste)

**`GET /agent-memory/list`**

<details open><summary><b>Params</b></summary>

```typescript
export interface AgentMemoryListParams {
  IDs?: Array<string> | null
  level?: AgentMemory_Level | null
  projectID?: string | null
  repositoryID?: string | null
  load?: AgentMemory_Load | null
  jobs?: Array<AgentMemory_Job> | null
  verified?: boolean | null
  shared?: boolean | null
  authorUID?: string | null
  query?: string | null
  unusedDays?: number | null
  sort?: agent_memory_list_sort | null
}
```

</details>

<details open><summary><b>Response</b></summary>

```typescript
export type AgentMemoryListResponse = IServerResponse<Resp_agent-memory_list>

export interface IServerResponse<T = any> {
  code: number
  data: T
  srvTS: number
  rkey: string
}
```

</details>

> Полный файл типов: [`/docs/types`](/docs/types) · raw: [`/docs/api-types.ts`](/docs/api-types.ts)

## Query parameters

- `IDs` string[], nullable
- `level` 'company' | 'user' | 'project' | 'repository': `company` = "company", `user` = "user", `project` = "project", `repository` = "repository"
- `projectID` string, uuid, nullable
- `repositoryID` string, uuid, nullable
- `load` 'always' | 'job' | 'request': `always` = "always", `job` = "job", `request` = "request"
- `jobs` AgentMemoryJob[], nullable
- `verified` boolean, nullable
- `shared` boolean, nullable
- `authorUID` string, uuid, nullable
- `query` string, nullable
- `unusedDays` integer, nullable
- `sort` 'usage': `usage` = "usage"

## Headers

- `devID` string, uuid, required
- `tz` string, required
- `app` string, required
- `appVer` string, required
- `rKey` string

## Response `200`

OK — `IServerResponse<Resp_agent-memory_list>`

- object
  - `code` integer, required
  - `data` RespAgentMemoryList, required: ResponseData for agent-memory/list
    - `list` AgentMemory[], required
      - `cID` string, uuid, nullable
      - `ID` string, uuid, required
      - `level` 'company' | 'user' | 'project' | 'repository', required: `company` = "company", `user` = "user", `project` = "project", `repository` = "repository"
      - `userID` string, uuid, nullable
      - `projectID` string, uuid, nullable
      - `repositoryID` string, uuid, nullable
      - `load` 'always' | 'job' | 'request': `always` = "always", `job` = "job", `request` = "request"
      - `jobs` AgentMemoryJob[]
      - `title` string, required
      - `text` string, required
      - `shared` boolean
      - `verified` boolean
      - `deliveredCount` integer
      - `readCount` integer
      - `lastUsedDT` string, date-time, nullable
      - `authorUID` string, uuid, required
      - `apiTokenID` string, uuid, nullable
      - `verifiedUID` string, uuid, nullable
      - `verifiedDT` string, date-time, nullable
      - `isDeleted` boolean
      - `createDT` string, date-time, required
      - `updUID` string, uuid, required
      - `version` integer, required: Unix timestamp in milliseconds
    - `repositories` AgentMemoryServiceRepositoryRef[], required: Доступные пользователю репозитории: названия и проекты - для отображения области и выбора при переносе
  - `srvTS` integer, required: Server timestamp (ms)
  - `rkey` string, required: Request key

## Other responses

- `400`: BadRequest / Validation — неверные params/body/headers
- `401`: Unauthorized: Active user session required
- `403`: AccessNotAllowed — privilegeRequired: нет привилегии; data.params = { code: 'privilegeRequired', allow, relation? }
- `406`: TimeResync — расхождение rts с сервером

---

[API](https://skmtc.dev/kosmodrom/apis/kosmodrom-backend-api.md) · [All operations](https://skmtc.dev/kosmodrom/apis/kosmodrom-backend-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kosmodrom/apis/kosmodrom-backend-api/revisions/a143b51ba29a?raw)