Las páginas sin traducir se abren en inglés y se indican como inglés.
Esta página es una traducción automática de la página en inglés, que prevalece. Machine-translated from the English page, which is authoritative.
Operaciones de collection
Los campos exactos que recibe y devuelve cada operación collection.*.
Cada op es POST /v1/<op> sobre HTTP y la herramienta MCP loom_<op>. Los campos de identidad (org, namespace, agent, user_id, session_id) se rellenan a partir del token y de la sesión MCP cuando el transporte puede hacerlo; en una llamada HTTP sin token en un servidor de un solo usuario, se usa la org de la instalación en todas las ops salvo code.* y tracker.* (que conservan la de su plano), y en algunas ops también su espacio de nombres y su agente; consulta identidades y espacios de nombres. El índice de operaciones explica el rol, el tipo y el listado all de MCP. Los campos de entrada desconocidos se atienden y se nombran en ignored_args.
collection.create
Crea una colección: un espacio de nombres que se lee y se escribe solo mediante permisos.
POST /v1/collection.create · MCP loom_collection_create · rol viewer · idempotente · auditada · no aparece en el conjunto de herramientas MCP all
| Campo de entrada | Tipo | Valor por defecto | Significado |
|---|---|---|---|
org |
str |
obligatorio | El tenant (primer elemento de la tupla de identidad). |
namespace |
str |
'' |
El nombre de la colección, que es también su espacio de nombres ('col-' seguido de letras minúsculas, dígitos y '-'); se ignora con derive_name. |
title |
str |
'' |
Cómo se llama la colección en pantalla (como máximo 200 caracteres, sin caracteres de control ni invisibles; los títulos se pueden repetir dentro de la org); '' para ninguno. |
derive_name |
bool |
False |
Deriva el nombre de title en lugar de namespace; si el título ya se usa bajo el padre (en el nivel superior: el del propio llamante), responde con esa colección. |
parent |
str |
'' |
La colección en la que se sitúa y de la que hereda permisos; '' para una de nivel superior. |
description |
str |
'' |
Qué contiene la colección, que se muestra junto a su nombre (como máximo 2000 caracteres); '' para ninguna. |
| Campo de salida | Tipo | Significado |
|---|---|---|
namespace |
str |
El espacio de nombres que la op lee o escribe. |
parent |
str |
La colección en la que se sitúa; '' para una de nivel superior. |
created |
bool |
False cuando la colección ya existía: la del propio llamante con ese nombre, o la que el título ya nombra allí. |
title |
str |
El título de la colección; '' para ninguno. |
collection.delete
Elimina una colección junto con lo que contiene: un borrado con purga del espacio de nombres (los documentos, los fragmentos, los originales y la memoria desaparecen del disco), después sale del directorio y del árbol, y su nombre no se vuelve a usar…
POST /v1/collection.delete · MCP loom_collection_delete · rol admin · idempotente · auditada · no aparece en el conjunto de herramientas MCP all
| Campo de entrada | Tipo | Valor por defecto | Significado |
|---|---|---|---|
org |
str |
obligatorio | El tenant (primer elemento de la tupla de identidad). |
namespace |
str |
obligatorio | El espacio de nombres que la op lee o escribe. |
| Campo de salida | Tipo | Significado |
|---|---|---|
namespace |
str |
El espacio de nombres que la op lee o escribe. |
deleted |
bool |
False cuando ya estaba eliminada |
erasure_id |
str |
El borrado de lo que contenía la colección; erasure.status le da seguimiento. |
erasure_status |
str |
El resultado de ese borrado: completed, o failed mientras el worker de recuperación lo reintenta. |
collection.list
Lista las colecciones que el llamante puede leer, por nombre.
POST /v1/collection.list · MCP loom_collection_list · rol viewer · lectura · no aparece en el conjunto de herramientas MCP all
| Campo de entrada | Tipo | Valor por defecto | Significado |
|---|---|---|---|
org |
str |
obligatorio | El tenant (primer elemento de la tupla de identidad). |
limit |
int |
500 |
Colecciones por página. |
include_document_counts |
bool |
False |
Incluye directamente en cada colección el número de documentos activos; false por defecto. |
cursor |
str \| None |
None |
El next_cursor de la página anterior; ninguno para la primera. |
| Campo de salida | Tipo | Significado |
|---|---|---|
collections |
list[_CollectionEntry] |
Las colecciones que el llamante puede leer en esta página, por nombre, con el rol del llamante y el título y la descripción de la colección. |
next_cursor |
str \| None |
Pásalo como cursor para la página siguiente; ninguno en la última. |
collection.move
Coloca una colección bajo otra, o la separa.
POST /v1/collection.move · MCP loom_collection_move · rol admin · idempotente · auditada · no aparece en el conjunto de herramientas MCP all
| Campo de entrada | Tipo | Valor por defecto | Significado |
|---|---|---|---|
org |
str |
obligatorio | El tenant (primer elemento de la tupla de identidad). |
namespace |
str |
obligatorio | El espacio de nombres que la op lee o escribe. |
parent |
str |
'' |
La nueva colección padre; '' la separa y conserva solo sus propios permisos. |
| Campo de salida | Tipo | Significado |
|---|---|---|
namespace |
str |
El espacio de nombres que la op lee o escribe. |
parent |
str |
La colección en la que se sitúa ahora; '' una vez separada. |
moved |
bool |
False cuando ya estaba allí |