---
title: "Add Evidence Endpoint"
method: POST
path: "/api/evidence"
tags: ["runtime_mutations", "ckg"]
---

# Add Evidence Endpoint

`POST /api/evidence`

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

Kernel-only on both mounts: this local route requires the kernel API
bearer token; the cloud mirror requires an internal principal.

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

## Request body

- AddEvidenceRequest — Payload for ``POST /api/evidence`` (records an untracked notebook variable as a notebook-captured claim).
  - `notebook_id` string, required — Notebook the value was produced in.
  - `description` string, required — Brief narrative of what the value shows.
  - `variable_name` string, required — Notebook variable name.
  - `value` unknown, required
  - `cell_id` string, nullable — Producing cell id when known; cited as the source.
  - `task_id` string, nullable — Optional task to associate the evidence claim with.
  - `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 `200`

Successful Response

- AddEvidenceResponse — Response for ``POST /api/evidence``.
  - `claim_id` string, nullable — Created claim id, or null when the request was rejected.
  - `rejected_reason` string, nullable — Why the request was rejected, when ``claim_id`` is null.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/quadrillion/apis/quadrillion-cloud-api.md) · [All operations](https://skmtc.net/quadrillion/apis/quadrillion-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/quadrillion/quadrillion-cloud-api/versions/399077308c86/schema)