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

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

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

# Operaciones de `inbox`

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

<!-- 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 completan 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 completa con 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="inboxlist"></a>

## `inbox.list`

Buzones que el llamador puede ver: los que pertenecen a ``namespace`` (el espacio de nombres autorizado) y, con ``mine_everywhere``, todos los buzones de la organización en los que el llamador puede publicar: uno cuyo espacio de nombres propietario el llamador…

`POST /v1/inbox.list` · MCP `loom_inbox_list` · rol `viewer` · lectura · no figura 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. |
| `agent` | `str` | `'-'` | El agente que escribe o lee; `'-'` o `'*'` significa cualquier agente donde la op lo permita. |
| `mine_everywhere` | `bool` | `False` | Lista también todos los buzones de la organización en los que el llamador puede publicar (escritura en su espacio de nombres propietario, o figurar como publicador); si es falso, lista solo los buzones que pertenecen a `namespace`. |
| `limit` | `int` | `200` | Se leen como máximo estas filas de buzones, de 1 a 500 (con `mine_everywhere`, antes del filtro de visibilidad). |

| Campo de salida | Tipo | Significado |
| --- | --- | --- |
| `inboxes` | `list[InboxPayload]` | Los buzones visibles, ordenados por nombre. |

<a id="inboxpolicy_list"></a>

## `inbox.policy_list`

Lista las políticas de confianza de un inbox.

`POST /v1/inbox.policy_list` · MCP `loom_inbox_policy_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. |
| `agent` | `str` | `'-'` | El agente que escribe o lee; `'-'` o `'*'` significa cualquier agente cuando la op lo permite. |
| `inbox` | `str` | obligatorio | El inbox cuyas reglas se listan; si el llamador no puede leerlo, la respuesta es 404. |

| Campo de salida | Tipo | Significado |
| --- | --- | --- |
| `policies` | `list[PolicyPayload]` | Todas las reglas vigentes del inbox, ordenadas por remitente y luego por tipo. |

<a id="inboxpolicy_set"></a>

## `inbox.policy_set`

Establece el modo de confianza que el propietario de un inbox eligió para un poster y un tipo de tarea (Loom lo almacena, nunca lo cambia).

`POST /v1/inbox.policy_set` · MCP `loom_inbox_policy_set` · rol `admin` · idempotente · auditado · 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. |
| `agent` | `str` | `'-'` | El agente que escribe o lee; `'-'` o `'*'` significa cualquier agente cuando la op lo permite. |
| `inbox` | `str` | obligatorio | El inbox al que pertenece la regla; quien llama debe ser admin de su espacio de nombres propietario. |
| `poster` | `str` | obligatorio | A quién cubre la regla: un sujeto, una etiqueta de agente, o `*` para todos los posters. |
| `kind` | `str` | `'*'` | El tipo de tarea que cubre la regla; `*` cubre todos los tipos. |
| `mode` | `Literal['deny', 'review', 'auto']` | obligatorio | `deny` rechaza el envío (403), `review` lo deja en `triage`, `auto` lo deja en `todo`. |
| `require_evidence` | `list[str]` | *(calculado)* | Campos del brief que deben estar presentes (una comprobación de forma al crear), p. ej. ["inputs.finding_id"]. |
| `remove` | `bool` | `False` | True elimina la regla (poster, kind) en lugar de establecerla. |

| Campo de salida | Tipo | Significado |
| --- | --- | --- |
| `policy` | `PolicyPayload \| None` | La regla tal como se almacenó; null cuando `remove` la eliminó. |
| `removed` | `bool` | True cuando la regla se eliminó. |

<a id="inboxprincipals"></a>

## `inbox.principals`

Las identidades que loom ya conoce en la organización: la fuente del selector de remitentes.

`POST /v1/inbox.principals` · MCP `loom_inbox_principals` · rol `admin` · idempotente · 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 operación lee o escribe. |
| `agent` | `str` | `'-'` | El agente que escribe o lee; `'-'` o `'*'` significa cualquier agente cuando la operación lo permite. |
| `inbox` | `str` | obligatorio | La inbox cuyos remitentes se marcan como `listed`; un nombre no registrado o ilegible se resuelve contra `namespace` sin ningún remitente listado. |
| `query` | `str` | `''` | Subcadena sin distinción entre mayúsculas y minúsculas que se compara con el subject y la etiqueta; "" devuelve a todos. |
| `limit` | `int` | `200` | Como máximo esta cantidad de principals, de 1 a 500; `truncated` indica que coincidieron más. |

| Campo de salida | Tipo | Significado |
| --- | --- | --- |
| `principals` | `list[Principal]` | Primero las personas, luego las cuentas de servicio y después las demás, cada grupo ordenado por etiqueta. |
| `truncated` | `bool` | Verdadero cuando coincidieron más principals que `limit`. |

<a id="inboxregister"></a>

## `inbox.register`

``namespace`` es el espacio de nombres propietario (quien llama debe ser su administrador).

`POST /v1/inbox.register` · MCP `loom_inbox_register` · rol `admin` · idempotente · auditado · no aparece en el conjunto de herramientas `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. |
| `agent` | `str` | `'-'` | El agente que escribe o lee; `'-'` o `'*'` significa cualquier agente donde la op lo permita. |
| `inbox` | `str` | obligatorio | El nombre del inbox, único en la org; registrar un nombre existente edita su configuración. |
| `owner_agent` | `str` | obligatorio | El agente que trabaja el inbox: un pull o claim que no indica `agent` reclama como este. |
| `description` | `str` | `''` | Texto libre que se muestra con el inbox; Loom no lo interpreta. |
| `posters` | `list[str]` | *(calculado)* | Sujetos autorizados a publicar además de quienes tienen permiso de escritura en el espacio de nombres propietario; una etiqueta de agente aquí solo admite a quien llama sin token. |
| `accept_disclosure` | `list[Literal['confidential', 'internal', 'public_ok']]` | *(calculado)* | Los niveles de `disclosure` que puede tener una tarea para llegar aquí; un create o reassign con cualquier otro nivel se rechaza (422). |
| `default_lease_seconds` | `int` | `1800` | Segundos que un claim o heartbeat mantiene el lease cuando la llamada no indica `lease_seconds`. |
| `max_attempts` | `int` | `3` | Leases vencidos que puede alcanzar una tarea; después, el sweeper la bloquea a la espera de una persona en lugar de devolverla a `todo`. |
| `max_defers` | `int` | `5` | Aplazamientos que puede tener una tarea; el siguiente `task.defer` la bloquea a la espera de una persona. |
| `triage_escalate_after_seconds` | `int` | `14400` | Segundos que una tarea puede esperar en `triage` antes de que el sweeper registre en ella un evento `triage_escalated`. |
| `webhook_url` | `str` | `''` | Dónde se envían por POST los avisos de activación firmados (tipos de evento e ids de tarea, nunca el texto de la tarea): una URL http(s) en un host público (se comprueba de nuevo en cada entrega); "" no envía ninguno. |
| `webhook_secret_ref` | `str` | `''` | Nombre de la variable de entorno que contiene el secreto de firma del webhook (nunca se almacena): `LOOM_WEBHOOK_SECRET_<ORG>__<NAME>`, donde ORG es el id de la org con a-z en mayúsculas, los dígitos conservados y cualquier otro byte como `_` y dos dígitos hexadecimales (`acme-corp` →… |
| `if_match_version` | `int \| None` | `None` | La `version` del inbox en la que se basó esta edición; si la versión actual es distinta, responde 409. |

| Campo de salida | Tipo | Significado |
| --- | --- | --- |
| `inbox` | `InboxPayload` | El inbox tal como quedó escrito. |
| `created` | `bool` | True cuando esta llamada registró un inbox nuevo; false para una edición de configuración. |

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