v1

latestOpenAPI 3.1.02026-07-26142186376.1 KB
Learnings

List Learnings

List learning records with pagination and optional filters. For a scoped (non-admin) caller with user isolation enabled, results are bound to that user and also include records with no owner (user_id IS NULL) — this covers global, agent, team, session, and entity-scoped learnings; passing a user_id that differs from the caller is rejected with 403. Admins and unscoped callers see all records (optionally filtered by user_id).

get/learnings

Query parameters

learning_typestring nullable

Filter by learning type

Filter by learning type

user_idstring nullable

Filter by user ID

Filter by user ID

agent_idstring nullable

Filter by agent ID

Filter by agent ID

team_idstring nullable

Filter by team ID

Filter by team ID

session_idstring nullable

Filter by session ID

Filter by session ID

namespacestring nullable

Filter by namespace

Filter by namespace

entity_idstring nullable

Filter by entity ID

Filter by entity ID

entity_typestring nullable

Filter by entity type

Filter by entity type

limitinteger

Page size

Page size

pageinteger

1-indexed page number

1-indexed page number

sort_bystring nullable

Field to sort by, e.g. created_at or updated_at (the default). An unrecognised field is ignored (the default ordering is used).

Field to sort by, e.g. created_at or updated_at (the default). An unrecognised field is ignored (the default ordering is used).

sort_order'asc' | 'desc'

Sort order (asc or desc)

db_idstring nullable

Database ID to query

Database ID to query

tablestring nullable

The database table to use (requires db_id)

The database table to use (requires db_id)

Response

Successful Response