Skip to content

Update Knowledge Item

PATCH /knowledge-items/{item_id}

Correct one remembered sentence. Changing content re-embeds it.

Re-embedding is not optional and not deferred: an item whose text says one thing and whose vector still means the previous thing is worse than either, because it is found by the old query and read as the new answer.

NameInTypeNotes
item_idpathstring (uuid)required—
FieldTypeNotes
contentstring | nulloptionalmin length 1
titlestring | nulloptionalmax length 300
tagsstring[] | nulloptional—
attributesobject | nulloptional—
provenanceobject | nulloptional—
confidencenumber | string | null | nulloptional—
importancelow | normal | high | nulloptional—
valid_fromstring (date-time) | nulloptional—
valid_untilstring (date-time) | nulloptional—
StatusDescriptionBody
200Successful ResponseKnowledgeItemDetail
422Validation ErrorHTTPValidationError
Terminal window
curl -X PATCH https://your-deployment.example.com/knowledge-items/{item_id} \
-H "Authorization: Bearer $COBRE_TOKEN"
FieldTypeNotes
idstring (uuid)required—
kb_idstring (uuid) | nullrequired, nullable—
item_scopekb | agent | subject | conversationrequired—
kindfact | rule | open_question | hubrequired—
titlestring | nullrequired, nullable—
contentstringrequired—
curation_statepending | reviewed | promoted | superseded | retiredrequired—
importancelow | normal | highrequired—
confidencestring | nullrequired, nullable—
originhuman | agent | import | derivedrequired—
use_countintegerrequired—
last_used_atstring (date-time) | nullrequired, nullable—
embedding_modelstring | nullrequired, nullable—
is_structuralbooleanrequired—
valid_fromstring (date-time)required—
valid_untilstring (date-time) | nullrequired, nullable—
created_atstring (date-time)required—
updated_atstring (date-time)required—
agent_idstring (uuid) | nullrequired, nullable—
persona_idstring (uuid) | nullrequired, nullable—
session_idstring (uuid) | nullrequired, nullable—
subject_kinduser | guest | nullrequired, nullable—
subject_idstring | nullrequired, nullable—
content_hashstringrequired—
tagsstring[]required—
attributesobjectrequired—
provenanceobjectrequired—
curated_atstring (date-time) | nullrequired, nullable—
reviewed_atstring (date-time) | nullrequired, nullable—
last_maintained_atstring (date-time) | nullrequired, nullable—