v2

latestOpenAPI 3.1.02026-08-0382170235.8 KB
facts
facts

Get a single fact by ID

Get a single fact by ID.

get/pots/{pot_id}/facts/{fact_id}

Path parameters

pot_idstring uuid required
fact_idstring uuid required

Response

Fact retrieved successfully

idstring uuid required

Unique identifier (UUID)

pot_idstring uuid required

POT this fact belongs to

workspace_idstring uuid nullable

Multi-tenant isolation. Defaults to DEV_WORKSPACE_ID if None.

contentstring required

The actual claim or statement

titlestring nullable

Short title (max 50 chars, hard limit 80) for graph node labels. Generated by LLM during extraction. None for legacy facts.

content_hashstring nullable

SHA-256 hash of content for deduplication

pot_scorenumber required

Certainty score (0.0-1.0, where 1.0 = CONSTITUTION)

original_pot_scorenumber nullable

Pre-propagation POT Score. None if propagation hasn't run.

level'CONSTITUTION' | 'VERIFIED' | 'SUPPORTED' | 'INFERRED' | 'HYPOTHESIS' | 'SPECULATION' required

POT Index levels matching score ranges.

embedding_modelstring nullable

Embedding model used, e.g. text-embedding-3-small

statusstring

Processing status (processing, ready, error)

validation_statusstring

Validation status (pending, validated, disputed, rejected)

created_atstring date-time

When fact was created

updated_atstring date-time

When fact was last updated

valid_fromstring date-time nullable

When the fact started being true

valid_untilstring date-time nullable

When the fact stopped being true

decay_ratenumber nullable

Temporal decay rate per month (null if no decay)

document_idstring uuid nullable

Document UUID this fact was extracted from. None for constitution facts and inline ingestion.

languagestring nullable

ISO 639-1 language code of the fact content (e.g. 'es', 'en'). Inherited from document language detection during extraction.

scope_inferred'own' | 'third_party' | 'mixed_context' | 'unknown' nullable

Per-fact scope classification from scope-aware extraction. 'own' = describes the operating organization's data; 'third_party' = describes external entities (case studies, customers); 'mixed_context' = blends first- and third-party content; 'unknown' = LLM could not determine. None = legacy fact, extraction predates scope-aware prompt.

scope_confidencenumber nullable

LLM-reported confidence (0.0-1.0) on the scope_inferred classification. ≥0.7 = trust; 0.4-0.7 = hint; <0.4 = manually verify. None when scope_inferred is None.

scope_reasonstring nullable

Short LLM-generated explanation of the scope_inferred classification (why this scope, what signal the LLM used). Used by KB2B tooltip to explain confidence to admins. None when scope_inferred is None.

context_attachment_ids_usedstring[] nullable

Snapshot of context_attachment_ids in scope at extraction time. Empty list = extraction ran under M21+ with zero attachments. None = legacy fact (pre-M21) or non-extraction-pipeline fact.

versioninteger

Version number (increments on update)

flagsstring[]

Special flags (needs_review, deprecated, etc.)

notesstring nullable

Internal notes