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.

Changes

Changed in 2 of the 16 revisions of this API.527

Aug 19, 2026bc8a81bf39141See the full diff
- ▲
  removed the enum value global of the request property recall_priority
  request-property-enum-value-removed
This revision also has 8 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Aug 12, 2026dcf9b4550387427See the full diff
- ▲
  removed subschema #1 from the cell_id request property anyOf list
  request-property-any-of-removed
- ▲
  removed subschema #1 from the task_id request property anyOf list
  request-property-any-of-removed
- ▲
  the variable_name request property's minLength was increased from 0 to 1
  request-property-min-length-increased
- ▲
  the notebook_id request property type/format changed from string/ to /
  request-property-type-changed
- ●
  the description request property's maxLength was set to 500
  request-property-max-length-set
- ●
  the variable_name request property's maxLength was set to 200
  request-property-max-length-set
- ○
  added the new optional request property session_id
  new-optional-request-property
- ○
  added the new optional request property source_file_path
  new-optional-request-property
- ○
  added the new optional request property source_line
  new-optional-request-property
- ○
  added _RuntimeId to the cell_id request property anyOf list
  request-property-any-of-added
- ○
  added _RuntimeId to the task_id request property anyOf list
  request-property-any-of-added
- ○
  added _RuntimeId subschema #2 to the notebook_id request property anyOf list
  request-property-any-of-added
- ○
  the request property notebook_id became optional
  request-property-became-optional

Full history