← Todas las herramientas
Escritura

Editar norma estructurada

norms_update

Reemplaza metadatos y, si se incluyen, secciones completas desde un JSON validado.

Propósito

Cuándo usarla

Cuando necesites editar norma estructurada.

Cuándo no usarla

No la uses sin una solicitud humana clara, grant de escritura y revisión del alcance.

Parámetros de entrada

ParámetroTipoRequisitoDetalle
norm_idstring (uuid)Obligatorio
normobjectObligatorioCampos y secciones de la norma que se actualizarán

Ejemplo completo

Entrada
{
  "norm_id": "11111111-2222-4333-8444-555555555555",
  "norm": {}
}
Salida
{
  "ok": true,
  "requestId": "req_01JEXAMPLE",
  "data": {
    "result": "Respuesta resumida de Voltline"
  }
}

Errores y recuperación

authentication_required

Reconecta Voltline mediante OAuth.

mcp_tool_grant_required

Confirma una conexión global de platform_admin activa y vuelve a intentar con el request ID.

organization_scope_mismatch

Selecciona una empresa incluida en la conexión.

internal_error

Entrega el request ID a soporte; no reenvíes tokens ni archivos.

Auditoría

Se registra

  • request ID
  • usuario y cliente OAuth
  • empresa y herramienta
  • resultado, duración y hash de argumentos

Nunca se registra

  • ×token
  • ×prompt completo
  • ×URL firmada
  • ×archivo
  • ×contraseña