---
title: "List Workspace Claims"
method: GET
path: "/api/workspaces/{workspace_id}/claims"
tags: ["runtime_mutations", "ckg"]
---

# List Workspace Claims

`GET /api/workspaces/{workspace_id}/claims`

List claims for a workspace with optional filters and DAG expansion.

HTTP callers receive every matching claim — the per-call recency cap
that ``get_claims`` applies to the LLM tool path is intentionally not
propagated here, since UI surfaces (CKG sidebar, task-DAG coloring,
writeup tables) need the full set. ``claim_ids`` is repeatable
(``?claim_ids=C-1&claim_ids=C-2``) for bulk lookup of a known set
without re-scanning the workspace.

## Path parameters

- `workspace_id` string, required

## Query parameters

- `claim_type` string, nullable
- `minimum_recall_priority` 'high' | 'medium' | 'low' — How readily a claim should enter an agent's context. This is a query-*independent* prior authored by the agent that files the claim. It is not relevance, confidence, or truth: a Low claim that is highly relevant to the current work must still be able to outrank an irrelevant High one once the recall system ranks candidates.
- `created_by_task_id` string, nullable
- `degree` integer
- `claim_ids` string[], nullable

## Response `200`

Successful Response

- ClaimsListResponse
  - `claims` ClaimResponse[], required
    - `claim_id` string, required
    - `workspace_id` string, required
    - `claim_type` string, required
    - `title` string, nullable
    - `content` string, required
    - `status` string, required
    - `review_status` string
    - `recall_priority` string
    - `created_by_session_id` string, nullable
    - `created_by_task_id` string, nullable
    - `updated_by_session_id` string, nullable
    - `linked_variable` object, nullable
    - `tabular_data` object, nullable
    - `figure_metadata` object, nullable
    - `created_at` string, required
    - `updated_at` string, required
    - `sources` ClaimSourceResponse[]
      - `id` integer, required
      - `claim_id` string, required
      - `source_type` string, required
      - `source_claim_id` string, nullable
      - `source_notebook_id` string, nullable
      - `source_notebook_path` string, nullable
      - `source_cell_id` string, nullable
      - `source_file_path` string, nullable
      - `source_section_heading` string, nullable
      - `source_line_start` integer, nullable
      - `source_line_end` integer, nullable
      - `source_page` integer, nullable
      - `source_text` string, nullable
      - `source_status` 'ok' | 'diverged' | 'missing' — Whether a recorded file-evidence quote still holds against the file.
      - `source_cell_part` 'source' | 'output' — Which half of a notebook cell a quoted span was taken from.
      - `source_output_index` integer, nullable
      - `captured_by` 'human' — Who performed a capture, when it was not an agent. Recorded on the source entry rather than as a column on ``claims``, following ``import_source_id``: the source already describes the capture (path, quote, line range, output index) and this is one more fact about it. Agent captures omit the key entirely, so the overwhelming majority of rows are unchanged. Deliberately not derived from a null ``created_by_session_id``: that column is ``ON DELETE SET NULL``, so deleting a chat session would silently reclassify its agent claims as human-authored.
    - `related_claim_ids` string[]
    - `associated_tasks` AssociatedTaskResponse[]
      - `task_id` string, required
      - `title` string, required
      - `status` string, required
      - `assigned_to_session_id` string, nullable
    - `associated_notebooks` AssociatedNotebookResponse[]
      - `notebook_id` string, required
      - `path` string, nullable
  - `related` object[]

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/quadrillion/apis/quadrillion-cloud-api.md) · [All operations](https://skmtc.net/quadrillion/apis/quadrillion-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/quadrillion/quadrillion-cloud-api/revisions/e99c1b6139c8/schema)