OpenAPI 3.1.02026-08-12358237329.2 KB

dcf9b4550387

runtime_mutations

ckg

Add Evidence Endpoint

Add a runtime-captured evidence claim for an untracked variable.

Runtime-only on both mounts: this local route requires a runtime caller (the kernel API bearer token, or an execution-scoped token issued to a script process); the cloud mirror requires an internal principal.

Rejections (unsupported value type, no project for the runtime, bad variable name) come back in rejected_reason rather than via HTTP error so the client can surface them in-cell without raising.

post/api/evidence

Request body

notebook_idstring

session_idstring

descriptionstring required

Brief narrative of what the value shows.

variable_namestring required

Runtime variable name.

{"stackTrail":"components:schemas:AddEvidenceRequest:properties:value","oasType":"schema","type":"unknown","title":"Value","description":"The value to record. Same shape as qualia.submit_variable."}

cell_idstring

source_file_pathstring nullable

Absolute path of the source file the call was made from, when the runtime can introspect its caller. Verified against the workspace.

source_lineinteger nullable

1-indexed line of source_file_path holding the call.

task_idstring

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.

Response

Successful Response

claim_idstring nullable

Created claim id, or null when the request was rejected.

rejected_reasonstring nullable

Why the request was rejected, when claim_id is null.