---
title: "Get Workspace Stats"
method: GET
path: "/api/v1/workspace/stats"
tags: ["workspace"]
---

# Get Workspace Stats

`GET /api/v1/workspace/stats`

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

Get aggregated statistics across all user's contexts.

Returns total memory count and per-context breakdown.

Args:
    user: Authenticated user from session or API key
    db: Database session

Returns:
    WorkspaceStatsResponse with aggregated stats

Example:
    GET /api/v1/workspace/stats
    Response: {
        "total_memories": 150,
        "context_count": 3,
        "contexts": [
            {"context_id": "...", "context_name": "default", "memory_count": 100},
            ...
        ],
        "plan_name": "pro"
    }

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- WorkspaceStatsResponse: Aggregated statistics across all user's contexts. Issue #165: Privacy-aware response with aggregation for inaccessible contexts. Single Collection Migration: total_storage_mb removed (memory count only).
  - `total_memories` integer, required
  - `context_count` integer, required
  - `contexts` ContextStats[], required
    - `context_id` string, required
    - `context_name` string, required
    - `created_by` string, nullable, required
    - `created_by_name` string, nullable, required
    - `memory_count` integer, required
    - `is_private` boolean
    - `unsearchable_count` integer
    - `stalled_count` integer
  - `private_aggregation` PrivateContextAggregation: Aggregated statistics for inaccessible private contexts. Single Collection Migration: storage_mb removed (memory count only).
    - `context_count` integer, required
    - `memory_count` integer, required
  - `plan_name` string, required
  - `unsearchable_memories` integer
  - `stalled_memories` integer

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