v4

latestOpenAPI 3.1.02026-08-08278476614.0 KB

knowledge

Update Knowledge Entry

Replace an entry's title + content (caller must be entitled to edit it).

patch/api/v1/knowledge/{entry_id}

Path parameters

entry_idstring uuid required

Request body

titlestring required

contentstring required

Response

Successful Response

idstring uuid required

scope'user' | 'workspace' | 'project' required

Tier a knowledge entry applies to.

Resolution is additive and ordered user -> workspace -> project — precedence is ordering only, not override (no shadowing in v1). "System" knowledge is the agent's existing system prompt — a separate, pre-existing mechanism that does not live in this table — so there is no system scope here. Project scope (MAIA-2547) is ambient: paths never name a project; the run's project id scopes reads and writes.

user_idstring uuid nullable

workspace_idstring uuid nullable

project_idstring uuid nullable

titlestring required

contentstring required

created_atstring date-time required

updated_atstring date-time required

is_coreboolean required

Whether this is the reserved always-injected core entry (MAIA-2833).