Confirmar una acción destructiva
Gestiona 412 confirmation_required: emite un token de confirmación y repite la llamada con X-Trustvice-Confirmation.
Gestiona 412 confirmation_required: emite un token de confirmación y repite la llamada con X-Trustvice-Confirmation.
Agentes, evidencias, gobernanza, comercio y divulgación están en Trustvice 360. Regístrate gratis y abre todas las suites desde un solo panel.
Tu llamador necesita una acción cuya confirmationPolicy es "always", lo que incluye toda acción destructive y billing_impacting. Trustvice no las ejecuta hasta que la petición lleva un token de confirmación reciente: una persona, o una concesión de autonomía explícita, tiene que haber dicho que sí, hace poco, para esta acción.
curlEl código lee los secretos de variables de entorno. Guárdalos en tu shell o en tu gestor de secretos, nunca en un archivo que subas. Las llamadas a acciones también envían X-Workspace-Id.
Llama a la acción protegida como siempre. Sin token responde 412 con el código confirmation_required. Las docs usan privacy.dsr.submit como ejemplo.
La llamada a mint devuelve el token en jti, la acción a la que está ligado en audience y cuándo caduca.
{ "ok": true,
"jti": "cnf_…",
"audience": "privacy.dsr.submit",
"autonomous": false,
"expiresAt": "2026-09-14T13:20:37.675Z" }
Trustvice 360: confíe en sus agentes de IA y gobiérnelos con evidencia firmada y verificable.
curl -sS -X POST https://api.trustvice.com/api/v1/actions/privacy.dsr.submit \
-H "Authorization: Bearer $TRUSTVICE_TOKEN" \
-H "X-Workspace-Id: ws_…" \
-H "Content-Type: application/json" \
-d '{ … }'{ "ok": false,
"error": { "code": "confirmation_required",
"message": "This action requires an explicit confirmation." } }Pide a POST /api/v1/confirmations/mint un token para ese id de acción. El token queda ligado al actor que llama y a la audiencia de la acción, dura segundos y se consume en el primer uso.
curl -sS -X POST https://api.trustvice.com/api/v1/confirmations/mint \
-H "Authorization: Bearer $TRUSTVICE_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "actionId": "privacy.dsr.submit" }'Envía la misma llamada otra vez con el jti del token en X-Trustvice-Confirmation. Ahora la acción se ejecuta y devuelve su resultado real.
curl -sS -X POST https://api.trustvice.com/api/v1/actions/privacy.dsr.submit \
-H "Authorization: Bearer $TRUSTVICE_TOKEN" \
-H "X-Workspace-Id: ws_…" \
-H "X-Trustvice-Confirmation: cnf_…" \
-H "Content-Type: application/json" \
-d '{ … }'Un agente que debe llamar a acciones protegidas sin un clic humano por llamada tiene una concesión de autonomía: limitada en el tiempo, con un techo de seguridad y registrada en el workspace. Concederla requiere un token de confirmación humano para la audiencia agents.autonomy.grant. Mientras haya una concesión activa que cubra la acción, mint devuelve tokens con autonomous: true para las acciones dentro de su alcance.
POST /api/v1/autonomy/grant { "maxSafetyLevel": …, "ttlSeconds": … }
POST /api/v1/autonomy/revoke
GET /api/v1/autonomy/statusCopiado de: /docs/confirmations
Todo lo anterior procede de las docs de Trustvice enlazadas en esta página. Donde una página de las docs dice más, esa es la referencia.
Emite un token de acceso OAuth, busca una acción en el catálogo público y llámala en POST /api/v1/actions/<id>.
Un email breve cuando añadimos recetas. Ningún otro correo, y puedes darte de baja desde cualquier mensaje.
Un endpoint POST por cada acción registrada, con el mismo comportamiento por REST y por MCP. Las docs listan cada acción con su entrada y sus permisos.