---
title: "Reference"
method: POST
path: "/api/v1/memory/reference"
tags: ["memory"]
---

# Reference

`POST /api/v1/memory/reference`

## Request

- Base URL: `https://memory.kagura-ai.com` (the document declares no server; this is the origin it was published from)
- URL: `https://memory.kagura-ai.com/api/v1/memory/reference`
- Auth: none declared

Get full memory details (Layer 3).

Retrieves complete memory data including:
- summary, context_summary, content
- details (JSONB)
- All metadata

Request:
    {
        "memory_id": "uuid",
        "version": 3            // optional (#2043): an earlier version
    }

Response:
    {
        "memory_id": "uuid",
        "summary": "...",
        "context_summary": "...",
        "content": "...",
        "details": {...},
        "type": "code",
        "importance": 0.8,
        "tags": [...],
        "context": {...},
        "created_at": "2025-11-20T...",
        "client": "web"
    }

Example:
    POST /api/v1/memory/reference
    Authorization: Bearer <session_token>

## Headers

- `authorization` string, nullable

## Request body

- ReferenceRequest: Request schema for reference() API.
  - `memory_id` string, uuid, required
  - `version` integer, nullable

## Response `200`

Successful Response

- ReferenceResponse: Response schema for reference() API (full details).
  - `memory_id` unknown, required
  - `summary` unknown, required
  - `context_summary` unknown, required
  - `content` unknown, required
  - `details` unknown, required
  - `type` unknown, required
  - `scope` unknown, required
  - `importance` unknown, required
  - `tags` unknown, required
  - `context` unknown, required
  - `created_at` unknown, required
  - `updated_at` unknown, required
  - `version` unknown, required
  - `historical` unknown
  - `current_version` unknown
  - `unavailable_fields` unknown
  - `client` unknown, required
  - `source_uri` unknown
  - `source_type` unknown
  - `outgoing_links` unknown
  - `outgoing_has_more` unknown
  - `incoming_links` unknown
  - `incoming_has_more` unknown
  - `supersede_candidate` unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/kagura-ai/apis/kagura-memory-cloud.md) · [All operations](https://skmtc.dev/kagura-ai/apis/kagura-memory-cloud/llms.txt) · [OpenAPI document](https://skmtc.dev/kagura-ai/apis/kagura-memory-cloud/revisions/09f17f5ada29?raw)