v1

latestOpenAPI 3.1.02026-07-26142186376.1 KB

Learnings

Update Learning

Update a learning record. Only content and metadata may be modified; identity fields (user_id, agent_id, team_id, etc.) are immutable. Provided fields fully replace the existing values. Records with no owner (user_id IS NULL — shared agent/team/session/entity learnings) are readable by any caller but may only be modified by an admin.

patch/learnings/{learning_id}

Path parameters

learning_idstring required

The learning ID

Query parameters

db_idstring nullable

Database ID to use

tablestring nullable

The database table to use (requires db_id)

Request body

contentobject nullable

Replacement content payload

metadataobject nullable

Replacement metadata

Response

Successful Response

learning_idstring required

Unique identifier for the learning record

learning_typestring required

Type of learning (e.g. 'user_profile', 'entity_memory')

namespacestring nullable

Namespace for scoping ('user', 'global', or custom)

user_idstring nullable

Associated user ID

agent_idstring nullable

Associated agent ID

team_idstring nullable

Associated team ID

session_idstring nullable

Associated session ID

entity_idstring nullable

Associated entity ID (for entity-specific learnings)

entity_typestring nullable

Entity type (e.g. 'person', 'company')

contentobject nullable

The learning content payload

metadataobject nullable

Optional metadata

created_atinteger nullable

Creation timestamp (Unix epoch seconds)

updated_atinteger nullable

Last update timestamp (Unix epoch seconds)