QUquadrillion
runtime_mutations
ckg

Add Evidence Endpoint

Changed on

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

  • Base URL
    https://api.quadrillion.io (the document declares no server; this is the origin it was published from)
  • URL
    https://api.quadrillion.io/api/evidence
  • Auth
    none declared

Request body

notebook_idstring
session_idstring
descriptionstring required

Brief narrative of what the value shows.

variable_namestring required

Runtime variable name.

valueunknown required
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

  • abf76937a751Revision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

  • bc8a81bf3914Revision changes
    • breaking

      removed the enum value global of the request property