---
title: "Explore"
method: POST
path: "/api/v1/memory/explore"
tags: ["memory"]
---

# Explore

`POST /api/v1/memory/explore`

## 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/explore`
- Auth: none declared

Explore related memories via graph traversal.

Neural Memory graph exploration using Activation Spreading.

Request:
    {
        "memory_id": "uuid",
        "depth": 2,
        "relation_types": ["neural_association"],
        "min_weight": 0.5
    }

Response:
    {
        "seed_memory": {...},
        "related_memories": [
            {
                "memory_id": "uuid2",
                "summary": "...",
                "activation": 0.85,
                "hop": 1,
                "weight": 0.92,
                "path": ["uuid", "uuid2"]
            }
        ],
        "metadata": {
            "total_activated": 15,
            "returned": 10
        }
    }

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

## Headers

- `authorization` string, nullable

## Request body

- ExploreRequest: Request schema for explore() API. Example: { "memory_id": "uuid", "depth": 2, "relation_types": ["neural_association"], "min_weight": 0.05 }
  - `memory_id` string, uuid, required: 起点メモリID
  - `depth` integer: 最大ホップ数
  - `relation_types` string[], nullable: フィルタするリレーションタイプ
  - `min_weight` number: 最小重み閾値（典型値: 0.02-0.05）

## Response `200`

Successful Response

- ExploreResponse: Response schema for explore() API. Returns: seed_memory: 起点メモリ related_memories: 関連メモリーリスト metadata: 探索メタデータ
  - `seed_memory` MemoryResponse, required: Response schema for single memory.
    - `memory_id` unknown, required
    - `summary` unknown, required
    - `context_summary` unknown, required
    - `type` unknown, required
    - `importance` unknown, required
    - `scope` unknown, required
    - `created_at` unknown, required
    - `updated_at` unknown
    - `client` unknown, required
    - `tags` unknown, required
    - `context` unknown, required
    - `score` unknown
    - `source_uri` unknown
    - `source_type` unknown
    - `superseded_by` unknown
    - `contradicts` unknown
    - `supersede_candidate` unknown
    - `folded` unknown
    - `version` unknown
    - `content` unknown
    - `content_truncated` unknown
    - `content_next_offset` unknown
    - `spans` unknown
  - `related_memories` RelatedMemoryResponse[], required
    - `memory_id` string, uuid, required
    - `summary` string, required
    - `context_summary` string, nullable, required
    - `type` string, required
    - `activation` number, required: 活性化強度 (0.0-1.0)
    - `hop` integer, required: 起点からのホップ数
    - `weight` number, required: エッジ重み
    - `path` string[], required: 起点からのパス
  - `metadata` object: 探索統計（total_activated, returned, etc.）

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