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 grants
Los campos exactos que recibe y devuelve cada operación grants.*.
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 la org de la instalación en todas las ops excepto 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.
grants.approve
Aprueba (o rechaza) una solicitud de concesión pendiente.
POST /v1/grants.approve · MCP loom_grants_approve · rol admin · idempotente · auditada · 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. |
subject |
str |
obligatorio | De quién se decide la solicitud pendiente: un correo electrónico o un claim sub de una cuenta de servicio. |
decision |
Literal['approve', 'reject'] |
'approve' |
approve activa el rol solicitado (o el de la sobrescritura); reject descarta la solicitud y conserva cualquier rol base, o elimina la fila cuando el sujeto no tenía acceso base. |
role |
Literal['viewer', 'writer', 'admin'] \| None |
None |
Aprueba con un rol distinto del solicitado (una solicitud de mantenedor respondida como lector). |
| Campo de salida | Tipo | Significado |
|---|---|---|
subject |
str |
El sujeto tal como lo escribió la solicitud. |
namespace |
str |
El espacio de nombres que la operación lee o escribe. |
decision |
Literal['approve', 'reject'] |
La decisión aplicada (repite la de la solicitud). |
role |
Literal['viewer', 'writer', 'admin'] \| None |
El rol aprobado (en reject, el rol que habría tenido la solicitud); None cuando no existía ninguna fila de concesión para el sujeto. |
decided_at |
datetime |
Cuándo se escribió la decisión (UTC). |
grants.create
Otorga a otro sujeto (usuario o cuenta de servicio) el rol de viewer / writer / admin sobre un espacio de nombres.
POST /v1/grants.create · MCP loom_grants_create · role admin · idempotent · audited
| 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. |
subject |
str |
obligatorio | Un identificador de inicio de sesión, un correo electrónico (admite una cuenta una vez que ese correo está verificado: el de una cuenta SSO o el de una cuenta vinculada) o un claim sub de una cuenta de servicio. |
role |
Literal['viewer', 'writer', 'admin'] |
obligatorio | viewer, writer o admin; un espacio de nombres de código solo admite viewer (lector) y admin (mantenedor). |
granted_by |
str |
'admin' |
Se ignora cuando hay autenticación: el servidor registra al llamante autenticado. |
replace |
bool |
False |
La tabla reemplaza según (org, namespace, subject), así que un create con un rol inferior al rol activo actual del sujeto lo rebajaría en silencio. |
| Campo de salida | Tipo | Significado |
|---|---|---|
org |
str |
El tenant (primer elemento de la tupla de identidad). |
namespace |
str |
El espacio de nombres que la op lee o escribe. |
subject |
str |
El sujeto tal como lo escribió la solicitud (la fila se guarda bajo el identificador de inicio de sesión de la cuenta cuyo correo verificado es, o si no, tal como se escribió). |
role |
Literal['viewer', 'writer', 'admin'] |
El rol que está activo ahora para el sujeto. |
granted_at |
datetime |
Cuándo se escribió la fila de la concesión (UTC). |
grants.list
Lista las concesiones activas en un espacio de nombres: quién tiene acceso y con qué rol.
POST /v1/grants.list · MCP loom_grants_list · role viewer · read
| 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. |
limit |
int |
100 |
Filas por página, una por persona, con la concesión más reciente primero; de 1 a 500. |
cursor |
str \| None |
None |
Reanuda la página anterior en el mismo espacio de nombres; sin definir para la primera página. |
fields |
list[str] \| None |
None |
Los campos de salida que lee el llamador (una lista blanca resuelta contra el modelo de fila; un nombre desconocido produce un 422); sin definir, todos los campos. |
| Campo de salida | Tipo | Significado |
|---|---|---|
rows |
list[_GrantEntry] |
Concesiones vigentes en el espacio de nombres, activas y pendientes (se excluyen las revocadas), de la más reciente a la más antigua; una fila por persona, con sus otras grafías en also. |
next_cursor |
str \| None |
Se pasa como cursor para obtener la página siguiente; None cuando esta página es la última. |
truncated |
bool |
True cuando hay más personas después de esta página (next_cursor está definido). |
grants.pending_for_me
Todas las solicitudes pendientes en los espacios de nombres que administra quien llama, en una sola instrucción.
POST /v1/grants.pending_for_me · MCP loom_grants_pending_for_me · 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). |
limit |
int |
500 |
Como máximo este número de solicitudes, de la más reciente a la más antigua; de 1 a 2,000. |
| Campo de salida | Tipo | Significado |
|---|---|---|
rows |
list[_PendingForMeEntry] |
Solicitudes pendientes de unión o de elevación en los espacios de nombres que administra quien llama, de la más reciente a la más antigua; vacío si quien llama es anónimo. |
grants.revoke
Elimina el permiso (grant) de un sujeto sobre un espacio de nombres.
POST /v1/grants.revoke · MCP loom_grants_revoke · rol admin · idempotente · 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. |
subject |
str |
obligatorio | El sujeto cuyo grant se revoca: un nombre de usuario (login), un correo electrónico o el sub de una cuenta de servicio; se elimina la fila de la persona bajo cada grafía verificada y se rechaza una solicitud pendiente. |
| Campo de salida | Tipo | Significado |
|---|---|---|
revoked |
bool |
True cuando se encontró y se revocó alguna de las filas de grant del sujeto; false cuando no tenía ninguna. |
revoked_at |
datetime \| None |
Cuándo se escribió la revocación (UTC); None cuando no se revocó nada. |
grants.share_agent
Permite que otro agente de la misma confianza del llamador lea, o escriba, en el espacio de nombres propio del llamador.
POST /v1/grants.share_agent · MCP loom_grants_share_agent · rol writer · idempotente · auditado · 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 propio del agente que llama, el único que puede compartir. |
grantee |
str |
obligatorio | El agente de la misma confianza con el que se comparte, tal como lo nombra su plano de control. |
role |
Literal['viewer', 'writer'] |
'viewer' |
Lo que ese agente puede hacer allí: viewer lee, writer también escribe. |
| Campo de salida | Tipo | Significado |
|---|---|---|
namespace |
str |
El espacio de nombres que la op lee o escribe. |
subject |
str |
El sujeto bajo el que se almacena la concesión, sa:<trust>:<agent>. |
role |
Literal['viewer', 'writer'] |
El rol que ahora está activo para ese agente. |
granted_at |
datetime |
Cuándo se escribió la fila de la concesión (UTC). |
grants.unshare_agent
Retira lo que quien llama prestó a otro agente de su confianza.
POST /v1/grants.unshare_agent · MCP loom_grants_unshare_agent · rol writer · idempotente · auditado · 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 propio del agente que llama. |
grantee |
str |
obligatorio | El agente de la misma confianza cuya concesión se va a revocar. |
| Campo de salida | Tipo | Significado |
|---|---|---|
revoked |
bool |
True cuando el agente tenía una concesión y se revocó. |
revoked_at |
datetime \| None |
Cuándo se escribió la revocación (UTC); None cuando no se revocó nada. |