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 webhook
Los campos exactos que recibe y devuelve cada operación webhook.*.
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.
webhook.deliveries
Los eventos de webhook del espacio de nombres de los últimos 3 días y su estado de entrega.
POST /v1/webhook.deliveries · MCP loom_webhook_deliveries · rol admin · idempotente · no figura en el listado 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. |
webhook_id |
str |
'' |
Solo los eventos de este webhook; "" = todos los webhooks del espacio de nombres. |
status |
Literal['pending', 'delivered', 'dead'] \| None |
None |
Solo los eventos en este estado; None = todos los estados. |
limit |
int |
100 |
Como máximo esta cantidad de eventos, los más recientes primero, 1-500. |
| Campo de salida | Tipo | Significado |
|---|---|---|
deliveries |
list[WebhookDelivery] |
Eventos, los más recientes primero. |
webhook.list
Los webhooks de memoria del espacio de nombres.
POST /v1/webhook.list · MCP loom_webhook_list · rol admin · idempotente · no figura en el listado 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. |
| Campo de salida | Tipo | Significado |
|---|---|---|
webhooks |
list[WebhookInfo] |
Los registros activos del espacio de nombres, los más antiguos primero. |
webhook.register
Registra una URL a la que se avisa cuando cambia la memoria del espacio de nombres.
POST /v1/webhook.register · MCP loom_webhook_register · rol admin · idempotente · auditada · no figura en el listado 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. |
url |
str |
obligatorio | Dónde se envían los eventos mediante POST: una URL https (http solo donde el despliegue lo permita) cuyo host se resuelva a direcciones públicas. |
secret_ref |
str |
obligatorio | Nombre de la variable de entorno que contiene el secreto de firma (nunca el secreto): LOOM_WEBHOOK_SECRET_<ORG>__<NAME>, con ORG el id de la org en mayúsculas y cada byte distinto de a-z y 0-9 como _ más dos dígitos hexadecimales. |
events |
list[Literal['memory.written', 'memory.revised', 'memory.tombstoned', 'memory.restored', 'memory.redacted', 'memory.erased']] |
(calculado) | Los tipos de evento que se envían; por defecto, todos. |
| Campo de salida | Tipo | Significado |
|---|---|---|
webhook |
WebhookInfo |
El registro tal como se almacenó. |
webhook.remove
Elimina un webhook de memoria; tras la llamada no se envía ninguno de sus eventos, salvo un POST que ya esté en curso.
POST /v1/webhook.remove · MCP loom_webhook_remove · rol admin · idempotente · auditada · no figura en el listado 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. |
webhook_id |
str |
obligatorio | El webhook_id que devolvió webhook.register o webhook.list. |
| Campo de salida | Tipo | Significado |
|---|---|---|
removed |
bool |
False cuando el espacio de nombres no tiene ningún webhook activo con ese id. |