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

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

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

# Operaciones de `admin`

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

<!-- 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 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 rellena 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="adminusers"></a>

## `admin.users`

Agrega los sujetos de namespace_grants + namespaces.owner_email, incorpora la última actividad del registro de auditoría y marca a los administradores de plataforma configurados.

`POST /v1/admin.users` · MCP `loom_admin_users` · rol `org_admin` · idempotente · 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 \| None` | `None` | El espacio de nombres que la op lee o escribe. |
| `include_service_accounts` | `bool` | `False` | Lista también los sujetos que no tienen ni correo de contacto ni contraseña (cuentas de servicio); desactivado, se omiten. |
| `limit` | `int` | `200` | Como máximo este número de usuarios, en orden de sujeto; de 1 a 1,000. |

| Campo de salida | Tipo | Significado |
| --- | --- | --- |
| `users` | `list[UserSummary]` | La página de usuarios en orden de sujeto, cada uno con sus permisos y los espacios de nombres que posee. |
| `total` | `int` | Usuarios que cumplen los filtros antes de aplicar `limit`. |
| `total_pending_elevations` | `int` | Permisos de esta página con una solicitud de elevación sin aprobar. |
| `total_active_last_7d` | `int` | Usuarios de esta página con una fila de auditoría en los últimos 7 días. |
| `platform_admins_configured` | `list[str]` | Las identidades de administrador de plataforma configuradas, ordenadas; vacío salvo que quien llama sea administrador de plataforma (o la autenticación esté desactivada). |

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