latestOpenAPI 3.1.02026-08-22379259358.7 KB

c53108d35a70

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 workspace 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'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.

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.