---
title: "Get Workspace Knowledge Summary"
method: GET
path: "/api/workspaces/{workspace_id}/knowledge-summary"
tags: ["runtime_mutations", "ckg"]
---

# Get Workspace Knowledge Summary

`GET /api/workspaces/{workspace_id}/knowledge-summary`

## Path parameters

- `workspace_id` string, required

## Query parameters

- `recent_limit` integer
- `refresh` boolean

## Response `200`

Successful Response

- KnowledgeSummaryResponse
  - `counts` object, required
  - `recent` KnowledgeSummaryClaimResponse[]
    - `claim_id` string, required
    - `claim_type` 'runtime-captured' | 'synthesized' | 'tabular' | 'figure' | 'file-captured' | 'live-data', required — Claim type constants. Runtime-captured evidence is a variable value read out of a live runtime — a notebook kernel (autocapture on cell run, or a cell-side ``qualia`` call) or a script process running under ``bash_command``. The value must come from the runtime; it can never be supplied as an agent tool argument. These are the primary source of evidence in the knowledge graph. A notebook is one runtime among several, which is why this type is not named for it. Findings (claim_type='synthesized' internally) combine 2+ existing claims into higher-order conclusions that interpret what the evidence means—not only restate source values. Tabular claims store structured data matrices with per-cell source references. Figure claims link to chart/visualization outputs captured from notebook cells. File-captured claims record a text span read by the backend from a workspace file (script, results file, log, etc.); like figures, the value is read from the source, never supplied by an agent tool argument. Claims from the retired knowledge-import pipeline were backfilled into this type.
    - `label` string, required
    - `review_status` 'pending' | 'accepted'
    - `created_at` string, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-23** `d7f2f3b8e82d` — 1 warning
  - added the new `live-data` enum value to the `recent/items/claim_type` response property for the response status `200`
- **2026-09-18** `abf76937a751` — 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2026-08-19** `bc8a81bf3914` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/quadrillion/apis/quadrillion-cloud-api/changes/api/workspaces/:workspace_id/knowledge-summary/get.md)

---

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