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

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

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

# Operações de `audit`

Os campos exatos que cada operação `audit.*` 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, o org da instalação em todas as ops, exceto `code.*` e `tracker.*` (que mantêm o 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="auditlist"></a>

## `audit.list`

Consulta o log de auditoria (hashes por linha com evidência de adulteração).

`POST /v1/audit.list` · MCP `loom_audit_list` · role `viewer` · leitura · 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` | None: todo namespace que o chamador pode ler; informar um que ele não pode ler resulta em uma página vazia. |
| `event_type` | `str \| None` | `None` | correspondência exata |
| `since` | `datetime \| None` | `None` | somente linhas com ts >= since |
| `limit` | `int` | `50` | No máximo este número de linhas por página, das mais novas para as mais antigas; de 1 a 500. |
| `cursor` | `str \| None` | `None` | token opaco da página anterior |
| `fields` | `list[str] \| None` | `None` | Os campos de saída que o chamador lê (uma lista de permissão resolvida contra o modelo da linha; um nome desconhecido gera um 422); se não definido, todos os campos. |

| Campo de saída | Tipo | Significado |
| --- | --- | --- |
| `rows` | `list[AuditListRow]` | A página de linhas de auditoria, das mais novas para as mais antigas (empates resolvidos por `request_id`). |
| `next_cursor` | `str \| None` | Passe de volta como `cursor` para a próxima página, mais antiga; None quando esta página é a última. |

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