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

<!-- i18n: source=docs/reference/operations/memory_schema.md blob=7c1e29147620aa0eb8e394ad2da9710d2e44ca26 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/memory_schema/), que prevalece.
> Machine-translated from the [English page](https://clickhouse.github.io/loom/reference/operations/memory_schema/), which is authoritative.

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

# Operaciones de `memory_schema`

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

<!-- 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="memory_schemaapprove"></a>

## `memory_schema.approve`

Aprueba (activa) o rechaza un esquema de registros propuesto.

`POST /v1/memory_schema.approve` · MCP `loom_memory_schema_approve` · rol `admin` · escritura · auditada · no aparece en el toolset `all` de MCP

| 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. |
| `name` | `str` | obligatorio | El esquema sobre el que se decide, por nombre. |
| `decision` | `Literal['approve', 'reject']` | obligatorio | `approve` pone el esquema en `active`; `reject` lo marca como `rejected`. |
| `reviewed_by` | `str` | `''` | Revisor de respaldo; se guarda solo cuando la solicitud no tiene un principal que registrar. |

| Campo de salida | Tipo | Significado |
| --- | --- | --- |
| `name` | `str` | El nombre del esquema, devuelto tal cual. |
| `status` | `str` | El estado almacenado ahora (`active` o `rejected`); vacío cuando ningún esquema tiene ese nombre. |
| `updated` | `bool` | False cuando ningún esquema tiene ese nombre y no se escribió nada. |

<a id="memory_schemalist"></a>

## `memory_schema.list`

Lista los esquemas de registros de un espacio de nombres; solo los activos, salvo que se use `include_proposed`.

`POST /v1/memory_schema.list` · MCP `loom_memory_schema_list` · rol `viewer` · lectura · no aparece en el toolset `all` de MCP

| 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. |
| `include_proposed` | `bool` | `False` | False lista solo los esquemas `active`; True lista todos los estados que no estén marcados como eliminados. |
| `limit` | `int` | `100` | Como máximo esta cantidad de esquemas (1–500), ordenados por nombre. |

| Campo de salida | Tipo | Significado |
| --- | --- | --- |
| `schemas` | `list[MemorySchemaSummary]` | Los esquemas del espacio de nombres con sus campos, ordenados por nombre. |

<a id="memory_schemapropose"></a>

## `memory_schema.propose`

Registra un esquema de registros como `proposed`, para que un administrador lo apruebe o lo rechace.

`POST /v1/memory_schema.propose` · MCP `loom_memory_schema_propose` · rol `writer` · escritura · auditada · no aparece en el toolset `all` de MCP

| 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. |
| `name` | `str` | obligatorio | El nombre del esquema; memory.record.write y las consultas lo referencian por este nombre. |
| `description` | `str` | `''` | Texto libre que se guarda con el esquema y que devuelve memory_schema.list. |
| `fields` | `list[SchemaFieldInput]` | obligatorio | Los contratos de los campos (1–64); un tipo, una restricción o un patrón incorrectos se rechazan al registrar. |
| `created_by` | `str` | `''` | Autor de respaldo; se guarda solo cuando la solicitud no tiene un principal que registrar. |
| `status` | `Literal['active', 'proposed']` | `'active'` | `active` se puede escribir de inmediato; `proposed` espera a memory_schema.approve. |

| Campo de salida | Tipo | Significado |
| --- | --- | --- |
| `schema_id` | `str` | El id del nuevo esquema; cada llamada de registro genera uno nuevo. |
| `name` | `str` | El nombre del esquema, devuelto tal cual. |
| `field_count` | `int` | Cuántos campos declara el esquema. |
| `status` | `str` | El estado con el que se guardó: `active` o `proposed`. |

<a id="memory_schemaregister"></a>

## `memory_schema.register`

Registra un esquema de registros tipados (con campos con nombre) para un espacio de nombres; los registros tipados se escriben luego contra él.

`POST /v1/memory_schema.register` · MCP `loom_memory_schema_register` · rol `admin` · escritura · auditada

| 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. |
| `name` | `str` | obligatorio | El nombre del esquema; memory.record.write y las consultas lo referencian por este nombre. |
| `description` | `str` | `''` | Texto libre que se guarda con el esquema y que devuelve memory_schema.list. |
| `fields` | `list[SchemaFieldInput]` | obligatorio | Los contratos de los campos (1–64); un tipo, una restricción o un patrón incorrectos se rechazan al registrar. |
| `created_by` | `str` | `''` | Autor de respaldo; se guarda solo cuando la solicitud no tiene un principal que registrar. |
| `status` | `Literal['active', 'proposed']` | `'active'` | `active` se puede escribir de inmediato; `proposed` espera a memory_schema.approve. |

| Campo de salida | Tipo | Significado |
| --- | --- | --- |
| `schema_id` | `str` | El id del nuevo esquema; cada llamada de registro genera uno nuevo. |
| `name` | `str` | El nombre del esquema, devuelto tal cual. |
| `field_count` | `int` | Cuántos campos declara el esquema. |
| `status` | `str` | El estado con el que se guardó: `active` o `proposed`. |

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