AI Memory

List AI memory entries

Retrieve AI memory entries readable by the caller: all environment entries, the caller's own user entries, and entries of objects the caller can read. Users with the "manage AI memory" system access right see all entries of all users and objects.

get/v1/ai/memory

Query parameters

scope'environment' | 'user' | 'object'

Limit result to entries of given scope

scopeIdinteger

Scope ID (user ID for user scope, object ID for object scope). Defaults to the caller's user ID for user scope.

Response

List of memory entries

idinteger

Unique entry identifier

scope'environment' | 'user' | 'object'

Entry scope

scopeIdinteger

User ID for user scope, object ID for object scope, 0 for environment scope

titlestring

Entry title (unique within scope)

contentstring

Entry content

createdBy'model' | 'human'

Who created the entry

sourceUserIdinteger

ID of the user on whose behalf the entry was created

sourceType'chat' | 'task' | 'operator' | 'human'

Execution context that created the entry

sourceIdinteger

Chat ID, AI task ID, or AI operator instance ID depending on source type (0 for human)

createdAtinteger

Creation time (UNIX timestamp)

updatedAtinteger

Last modification time (UNIX timestamp)

lockedboolean

True if the entry cannot be changed or deleted by the model

Changes

Changed in 1 of the 128 revisions of this API.1