> Source: https://clickhouse.github.io/loom/es/reference/operations/collection/ (Markdown: https://clickhouse.github.io/loom/es/reference/operations/collection.md)

<!-- i18n: source=docs/reference/operations/collection.md blob=c6923c62aee6e89e254a9af29040b8fc1740a6e7 model=claude-sonnet-5-5 -->
> Esta página es una traducción automática de la [página en inglés](https://clickhouse.github.io/loom/reference/operations/collection/), que prevalece.
> Machine-translated from the [English page](https://clickhouse.github.io/loom/reference/operations/collection/), which is authoritative.

<a id="collection-operations"></a>

# Operaciones de `collection`

Los campos exactos que recibe y devuelve cada operación `collection.*`.

<!-- Generated by `python scripts/codegen/docs_reference.py` from the op registry; edit the models, not this page. -->

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](https://github.com/ClickHouse/loom/blob/main/docs/reference/http-api.md#request) también su espacio de nombres y su agente; consulta [identidades y espacios de nombres](https://github.com/ClickHouse/loom/blob/main/docs/concepts/identities-and-namespaces.md). El [índice de operaciones](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations.md) explica el rol, el tipo y el listado `all` de MCP. Los campos de entrada desconocidos se atienden y se nombran en `ignored_args`.

<!-- prettier-ignore-start -->

<a id="collectioncreate"></a>

## `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. |

<a id="collectiondelete"></a>

## `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. |

<a id="collectionlist"></a>

## `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. |

<a id="collectionmove"></a>

## `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í |

<!-- prettier-ignore-end -->
