VolundOS
Referência da APIGovernança

Auditoria da Governança

A aba Auditoria: quem mudou o quê no período, paginado por cursor. `formato=csv` traz todas as linhas do período e dos filtros. `conversas=1` com `pessoa`, `acao`, `chave` e `dia` lista as conversas de uma linha agrupada. A mesma operação da tool MCP governance_access.audit. Exige o escopo governance:read.

Atualizado em 04 de novembro de 2026
GET
/v1/governance/audit

Authorization

chaveDeApi
AuthorizationBearer <token>

Chave de API da organização, criada nas configurações. Envie-a em Authorization: Bearer <sua chave>.

In: header

Query Parameters

periodo?string

Janela: 24h, 7d, 30d (padrão), 90d, um mês (AAAA-MM) ou um intervalo de dias (AAAA-MM-DD..AAAA-MM-DD, até 366 dias). Fuso America/Sao_Paulo.

unidade?array<string>

Recorta pelas unidades de negócio (pode repetir): o id da unidade ou sem para "Sem unidade".

pessoa?array<string>

Pessoas (pode repetir).

agente?string

O agente envolvido.

acao?string

A ação inteira ou só o verbo.

alvo?string

O que aconteceu com este agente ou regra.

origem?string

Por onde a mudança entrou.

Value in

  • "tela"
  • "mcp"
  • "api"
antes?string

Cursor.

limite?string

Tamanho da página.

formato?string

csv devolve o arquivo inteiro com os mesmos filtros, em text/csv.

Value in

  • "json"
  • "csv"
conversas?string

1 para as conversas de uma linha agrupada.

chave?string

Com conversas: a chave da linha.

dia?string

Com conversas: AAAA-MM-DD.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/governance/audit"
{}