Saltar a contenido

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.