Listar memorias de la organización

GET

/v1/org/{org_id}/memory

memory.view — OWNER ADMIN OPERATOR VIEWER

Opcionalmente filtrado por scope / agente / huérfanas.

Autorizaciones

bearer

Token de servicio (kjtk_live_…), creado desde el panel en Ajustes → Tokens de servicio. Pertenece a una organización y lleva sus propios permisos.

Tipo

HTTP (bearer)

o

JWT

Sesión de una persona en el panel. No sirve para integrar.

Tipo

HTTP (bearer)

Parámetros

Parámetros de la ruta

org_id*

Tipo

number

Requerido

Parámetros de consulta

scope

Restrict to one scope

Tipo

string

Valores válidos

"SHORT_TERM""LONG_TERM"

scopes

Memory scopes to keep (SHORT_TERM/LONG_TERM). Repeat or CSV. Wins over the legacy single-scope scope if both are sent.

Tipo

array

agent_id

Restrict to memories assigned to this agent (handy for the per-agent view).

Tipo

number

Mínimo

1

unassigned

When true, only return memories with zero assignments (orphans). Default false.

Tipo

boolean

archived

When true, return ONLY archived (soft-deleted) memories. Default false → live memories only. The two sets never mix; the trash view in the operator UI uses this flag.

Tipo

boolean

search

Free-text search across name + description (case-insensitive substring).

Tipo

string

sort_by

Sort column.

Tipo

string

Valores válidos

"updated_at""name""created_at"

sort_dir

Sort direction.

Tipo

string

Valores válidos

"asc""desc"

limit

Page size (1-200). Default 200 (folder UI loads all).

Tipo

number

Mínimo

1

Máximo

200

offset

Offset (>= 0). Default 0.

Tipo

number

Mínimo

0

Respuestas

Content-Type

application/json

{

  

"rows": [

  

  

{

  

  

  

"id": 1,

  

  

  

"name": "guia-marca.md",

  

  

  

"description": "Brand voice and tone guidelines for customer replies.",

  

  

  

"scope": "SHORT_TERM",

  

  

  

"content_hash": "string",

  

  

  

"assignment_count": 3,

  

  

  

"created_by": 0,

  

  

  

"created_at": "string",

  

  

  

"updated_at": "string",

  

  

  

"archived_at": "string",

  

  

  

"canonical_kind": "IDENTITY"

  

  

}

  

],

  

"total": 31,

  

"limit": 200,

  

"offset": 0

}

GET

/v1/org/{org_id}/memory

Pruébalo

Autorización

bearer

Variables

Clave

Valor

org_id*

scope

scopes

agent_id

unassigned

archived

search

sort_by

sort_dir

limit

offset

Ejemplos