VolundOS
Referência da APIGovernança

Editar ou ligar guardrail

Corpo completo edita um guardrail da organização; `{ enabled }` sozinho liga ou desliga qualquer guardrail da organização, inclusive o de agente. A mesma operação da tela e da tool MCP governance_guardrails.update. Exige o escopo governance:write.

Atualizado em 04 de novembro de 2026
PATCH
/v1/governance/guardrails/{id}

Authorization

chaveDeApi
AuthorizationBearer <token>

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

In: header

Path Parameters

id*string

O guardrail.

Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

{ name, hook_event, tool_matchers, match_condition, action (deny | webhook | llm_judge | platform_agent | classifier), action_config, outcome (block | rewrite | flag), message, timeout_seconds, enabled }.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://example.com/v1/governance/guardrails/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Content-Type: application/json" \  -d '{}'
{}

Criar guardrail da organização

Cria um guardrail da organização. O segredo de um webhook volta UMA vez em `webhook_secret`. A mesma operação da tela e da tool MCP governance_guardrails.create. Exige o escopo governance:write.

Apagar guardrail da organização

Apaga um guardrail da organização. A mesma operação da tela e da tool MCP governance_guardrails.delete. Exige o escopo governance:write.