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 inbox
Los campos exactos que recibe y devuelve cada operación inbox.*.
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 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.
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. |
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. |
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ó. |
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. |
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. |