VolundOS
Referência da APIGovernança

Inventário da Governança

Uma sub-aba do Inventário, com as contagens das cinco sempre. Agentes: busca, situação, dono, modelo, integração e página (limite 1..200, padrão 50); `formato=csv` traz a lista inteira. Integrações: busca, tipo e página, com o resumo por tipo. Pessoas: unidade, busca, ferramenta, ordem e página. Sem `limite`, integrações e pessoas vêm inteiras. A mesma operação da tool MCP governance_assets.inventory. Exige o escopo governance:read.

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

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.

aba?string

A sub-aba.

Value in

  • "agentes"
  • "modelos"
  • "integracoes"
  • "externas"
  • "pessoas"
busca?string

Busca pelo nome.

situacao?string

Agentes: situação.

Value in

  • "ativo"
  • "parado"
  • "pausado"
dono?array<string>

Agentes: ids dos donos (pode repetir).

modelo?string

Agentes: modelo principal.

integracao?string

Agentes: integracao:<chave> ou mcp:<chave>.

tipo?string

Integrações: o tipo.

Value in

  • "integracao"
  • "mcp"
unidade?array<string>

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

ferramenta?string

Pessoas: o id da fonte ou __plataforma__.

ordem?string

Pessoas: por gasto na plataforma ou fora.

Value in

  • "plataforma"
  • "externo"
limite?string

Tamanho da página.

offset?string

Deslocamento da página.

formato?string

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

Value in

  • "json"
  • "csv"

Response Body

application/json

application/json

application/json

application/json

application/json

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

Consumo da Governança

A aba Consumo: cartões com a variação sobre o período anterior, gasto por modelo, origens, dispersão, quem dispara e pessoas. A mesma operação da tool MCP governance_usage.consumption. Exige o escopo governance:read.

Ficha de um agente

A ficha de um agente no Inventário: situação, dono, consumo, qualidade, alcance (integrações, MCP, repositórios, delegados, guardrails) e falhas no período. A mesma operação da tool MCP governance_assets.agent_card. Exige o escopo governance:read.