v4

latestOpenAPI 3.1.02026-08-08349225311.7 KB

runtime_mutations

ckg

List Project Claims

List claims for a project 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 project.

get/api/projects/{project_id}/claims

Path parameters

project_idstring required

Query parameters

claim_typestring nullable

minimum_recall_priority'global' | '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 Global one once the recall system ranks candidates.

GLOBAL is the only value with delivery semantics rather than ranking semantics: it is injected unconditionally into every agent in the workspace. Every claim type carries a priority — evidence, figures, and findings can all be the thing future agents most need to see.

created_by_task_idstring nullable

degreeinteger

claim_idsstring[] nullable

Response

Successful Response

relatedobject[]