Create Learning

curl --request POST \ --url https://api.example.com/learnings \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "learning_type": "<string>", "content": {}, "namespace": "<string>", "user_id": "<string>", "agent_id": "<string>", "team_id": "<string>", "session_id": "<string>", "entity_id": "<string>", "entity_type": "<string>", "metadata": {} } '

{ "learning_id": "<string>", "learning_type": "<string>", "namespace": "<string>", "user_id": "<string>", "agent_id": "<string>", "team_id": "<string>", "session_id": "<string>", "entity_id": "<string>", "entity_type": "<string>", "content": {}, "metadata": {}, "created_at": 123, "updated_at": 123 }

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

db_id

string | null

Database ID to use

table

string | null

The database table to use (requires db_id)

Body

application/json

Request body for creating a learning record.

learning_type

string

required

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

content

Content · object

required

The learning content payload

namespace

string | null

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

user_id

string | null

Associated user ID. When the request is authenticated, must match the JWT subject or be omitted/null (which creates a global / non-user-scoped record).

agent_id

string | null

Associated agent ID

team_id

string | null

Associated team ID

session_id

string | null

Associated session ID

entity_id

string | null

Associated entity ID

entity_type

string | null

Entity type

metadata

Metadata · object

Optional metadata

Response

Learning created successfully

A single learning record as returned by the API.

learning_id

string

required

Unique identifier for the learning record

learning_type

string

required

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

namespace

string | null

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

user_id

string | null

Associated user ID

agent_id

string | null

Associated agent ID

team_id

string | null

Associated team ID

session_id

string | null

Associated session ID

entity_id

string | null

Associated entity ID (for entity-specific learnings)

entity_type

string | null

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

content

Content · object

The learning content payload

metadata

Metadata · object

Optional metadata

created_at

integer | null

Creation timestamp (Unix epoch seconds)

updated_at

integer | null

Last update timestamp (Unix epoch seconds)