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

<!-- i18n: source=docs/reference/operations/admin.md blob=f39b9129b91eb2d7bee29920a25a97a24df4b80b model=claude-sonnet-5-5 -->
> Esta página é uma tradução automática da [página em 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>

# Operações `admin`

Os campos exatos que cada operação `admin.*` recebe e retorna.

<!-- Generated by `python scripts/codegen/docs_reference.py` from the op registry; edit the models, not this page. -->

Toda op é `POST /v1/<op>` via HTTP e a ferramenta MCP `loom_<op>`. Os campos de identidade (`org`, `namespace`, `agent`, `user_id`, `session_id`) são preenchidos a partir do token e da sessão MCP quando o transporte consegue; em uma chamada HTTP sem token em um servidor de usuário único, vale a org da instalação em todas as ops exceto `code.*` e `tracker.*` (que mantêm a do seu plano), e em [algumas ops](https://github.com/ClickHouse/loom/blob/main/docs/reference/http-api.md#request) também o namespace e o agente; veja [identidades e namespaces](https://clickhouse.github.io/loom/pt-BR/concepts/identities-and-namespaces/). O [índice de operações](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations.md) explica role, kind e a listagem `all` do MCP. Campos de entrada desconhecidos são atendidos e nomeados em `ignored_args`.

<!-- prettier-ignore-start -->

<a id="adminusers"></a>

## `admin.users`

Agrega os subjects de namespace_grants + namespaces.owner_email, inclui a última atividade a partir do log de auditoria e marca os administradores da plataforma configurados.

`POST /v1/admin.users` · MCP `loom_admin_users` · role `org_admin` · idempotente · não listada no toolset `all` do MCP

| Campo de entrada | Tipo | Padrão | Significado |
| --- | --- | --- | --- |
| `org` | `str` | obrigatório | O tenant (primeiro elemento da tupla de identidade). |
| `namespace` | `str \| None` | `None` | O namespace que a op lê ou grava. |
| `include_service_accounts` | `bool` | `False` | Lista também os subjects sem e-mail de contato e sem senha (contas de serviço); desativado, eles ficam de fora. |
| `limit` | `int` | `200` | No máximo este número de usuários, em ordem de subject; de 1 a 1,000. |

| Campo de saída | Tipo | Significado |
| --- | --- | --- |
| `users` | `list[UserSummary]` | A página de usuários em ordem de subject, cada um com seus grants e os namespaces que possui. |
| `total` | `int` | Usuários que correspondem aos filtros antes de aplicar `limit`. |
| `total_pending_elevations` | `int` | Grants nesta página com uma solicitação de elevação não aprovada. |
| `total_active_last_7d` | `int` | Usuários nesta página com uma linha de auditoria nos últimos 7 dias. |
| `platform_admins_configured` | `list[str]` | As identidades de administrador da plataforma configuradas, ordenadas; vazio, a menos que quem chama seja administrador da plataforma (ou a autenticação esteja desativada). |

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