Operações de `audit`
Esta página é uma tradução automática da página em inglês, que prevalece. Machine-translated from the English page, which is authoritative.
Os campos exatos que cada operação audit.* recebe e retorna.
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 também o namespace e o agente; veja identidades e namespaces. O índice de operações explica role, kind e a listagem all do MCP. Campos de entrada desconhecidos são atendidos e nomeados em ignored_args.
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. |