Every entry in the global knowledge base has a stable id and a content hash. That lets an agent fetch a fact, cite it, and check later that it has not changed.
The guarantee underneath: an identical query against the same kb_snapshot returns identical results in a stable order. The same operations are available as MCP tools. For the terms used here, see the glossary.
Returns one entry verbatim by its stable id.
curl "https://cold-api.coldstate.ai/v1/knowledge/fetch?id=eng_000229f438f7cebd" \ -H "Authorization: Bearer cs_live_..."
idstring — Stable entry id.title, snippetstring — Title and a short excerpt.contentstring — The full entry text.content_hashstring — sha256 of content. Store it to verify later.kb_snapshotstring — The knowledge-base version the entry was read from.metadataobject — domain and source.created_atstring — When the entry was created.Returns a canonical citation without the full text: what you need to attribute a fact and re-check it.
curl "https://cold-api.coldstate.ai/v1/knowledge/cite?id=eng_000229f438f7cebd" \ -H "Authorization: Bearer cs_live_..."
id, titlestring — The entry and its title.metadataobject — domain and source.content_hashstring — Fingerprint of the entry text at citation time.kb_snapshotstring — Knowledge-base version cited.built_at, created_atstring — Build and creation timestamps.Send the id and the content_hash you stored. The response says whether the entry still exists and still matches.
curl -X POST https://cold-api.coldstate.ai/v1/knowledge/verify \
-H "Authorization: Bearer cs_live_..." \
-H "Content-Type: application/json" \
-d '{"id": "eng_000229f438f7cebd", "content_hash": "<hash you stored>"}'foundboolean — Whether the entry exists in the current knowledge base.matchesboolean — Whether its current hash equals the one you sent.current_hashstring | null — The entry's hash now.kb_snapshotstring | null — The snapshot it was checked against.Returns the current knowledge-base version. Record it alongside a run so the run can be reproduced or audited later.
curl https://cold-api.coldstate.ai/v1/knowledge/snapshot \ -H "Authorization: Bearer cs_live_..."
kb_snapshotstring — Snapshot id.versionstring — Knowledge-base version.built_atstring — When the snapshot was built.entry_countinteger — Entries in the snapshot.Turns a name or alias into a canonical entry id you can pass to the other endpoints.
curl "https://cold-api.coldstate.ai/v1/knowledge/resolve?query=photosynthesis" \ -H "Authorization: Bearer cs_live_..."
querystring, required, max 500 chars — The name or alias to resolve.limitinteger, 1–5 — Max alternatives to return.resolvedentry | null — The canonical entry, if one was found.match_typeexact | best | none — How the entry was matched.alternativesarray — Other candidate entries.Sends up to 10 queries in one call, all answered from a single consistent snapshot.
curl -X POST https://cold-api.coldstate.ai/v1/knowledge/batch \
-H "Authorization: Bearer cs_live_..." \
-H "Content-Type: application/json" \
-d '{"queries": ["photosynthesis", "cellular respiration"], "limit": 5}'queriesarray of strings, required, 1–10 — Each up to 2000 characters.domainstring — Optional domain filter for all queries.limitinteger, 1–20, default 5 — Max results per query.kb_snapshotstring — The snapshot every query in the batch was answered from.searches[]array — One item per query: query, total and results.GET /v1/search/domainsKnowledge domains with entry counts.GET /v1/knowledge/statsWith a query: coverage stats for it. Without: global knowledge-base stats. Optional query and domain parameters.GET /v1/knowledge/capabilitiesMachine-readable manifest of the service, for agents that self-configure.See the API reference for every endpoint, or the quickstart to make your first search.