---
title: "ai.memory.read · OpenVibe.Services"
canonical: "https://openvibe.services/docs/capabilities/ai.memory.read"
updated: null
---

# ai.memory.read · OpenVibe.Services

HTML: [ai.memory.read · OpenVibe.Services](https://openvibe.services/docs/capabilities/ai.memory.read)

# `ai.memory.read`

Generated at 2026-11-13 06:25:48 UTC from [`openvibe-contracts v0.419.0`](https://github.com/OpenVibers/OpenVibe.Contracts/tree/v0.419.0) and [`openvibe-sdk v0.161.0`](https://github.com/OpenVibers/OpenVibe.SDK/tree/v0.161.0).

Not grantable to apps (active, first-party).

Read a person's memory from OpenVibe.AI (Memory M2): GET /api/v1/memory/items, /items/{id}, /profile and /search. The person's own token reads their own items; a service with ai.memory.read acting on\_behalf\_of a person searches only the scopes its grant names (user always; project:\* only for Codes runs in that project), gets active items only, at most 8, and is audited in memory\_reads with item ids and never text. Suggested, archived and conflict items never reach an agent.

- Owner: ai (token audience `openvibe.ai`)
- Version: 1.0
- Status: active
- Visibility: first-party
- Resource constraints: owner
- Quota class: ai-memory
- Permissions: ai:memory:read
- Input: [common.no-body@1](/docs/contracts/common.no-body)
- Output: ai.memory-result@1
- Events: —
- Implemented by: - `GET /api/v1/memory/items`
- `GET /api/v1/memory/items/:id`
- `GET /api/v1/memory/profile`
- `GET /api/v1/memory/search`

[These routes in the API explorer](/docs/api/ai#cap-ai.memory.read)