v2

latestOpenAPI 3.1.02026-08-0382170235.8 KB

contribution

Contribute expert knowledge

Contribute knowledge with a contributor profile.

The contributed content is extracted into facts. Each fact receives a POT Score based on the contributor's expertise relevance to the fact's domain:

Score formula: 0.55 + (expertise_relevance × 0.30)
Range: 0.55 (no expertise match) to 0.85 (perfect expert)

Optionally runs post-ingestion (edge detection + score propagation).

post/pots/{pot_id}/facts/contribute

Path parameters

pot_idstring uuid required

Request body

contentstring required

Knowledge content to contribute (will be extracted into facts)

contributor_idstring uuid required

Contributor registry ID (must be a registered, active contributor)

run_post_ingestionboolean

Whether to run edge detection and score propagation after contribution

influence_factornumber nullable

Integrator-defined seniority influence factor (0.0-1.0). Scales the contribution score range.

endorsedboolean

Expert endorsement (a thumbs-up). When true, the contributed facts are floored at the VERIFIED level regardless of the measured expertise match — used when a domain expert directly answers a knowledge gap. The resulting high certainty also stops the gap from being re-flagged on future queries.

Response

Facts created from contribution

pot_idstring uuid required

facts_createdinteger required

Number of facts extracted and saved

fact_idsstring[]

IDs of created facts

avg_pot_scorenumber required

Average POT Score of created facts

edges_createdinteger

Edges created by post-ingestion

scores_updatedinteger

Scores updated by propagation