Sign in
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.

Changes

Changed in 3 of the 30 revisions of this API.529

  • abf76937a7512See the full diff
    • ○

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

      response-optional-property-added

    • ○

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

      response-optional-property-added

    This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • bc8a81bf39141See the full diff
    • ▲

      removed the enum value global of the request property

      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

  • dcf9b4550387427See the full diff
    • ▲

      removed subschema #1 from the request property anyOf list

      request-property-any-of-removed

    • ▲

      removed subschema #1 from the request property anyOf list

      request-property-any-of-removed

    • ▲

      the request property's minLength was increased from 0 to 1

      request-property-min-length-increased

    • ▲

      the request property type changed from string to no type

      request-property-type-changed

    • ●

      the request property's maxLength was set to 500

      request-property-max-length-set

    • ●

      the request property's maxLength was set to 200

      request-property-max-length-set

    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      added to the request property anyOf list

      request-property-any-of-added

    • ○

      added to the request property anyOf list

      request-property-any-of-added

    • ○

      added subschema #2 to the request property anyOf list

      request-property-any-of-added

    • ○

      the request property became optional

      request-property-became-optional