Gestisci 412 confirmation_required: ottieni un token di conferma e ripeti la chiamata con X-Trustvice-Confirmation.
Agenti, prove, governance, commercio e informativa sono in Trustvice 360. Registrati gratis e apri tutte le suite da un'unica dashboard.
© 2026 Trustvice. Tutti i diritti riservati. Trustvice è un prodotto di Trustvice. Secured and supercharged by Avonao Labs.
Segnala abusoIl tuo chiamante ha bisogno di un’azione con confirmationPolicy "always", cioè ogni azione destructive e billing_impacting. Trustvice non le esegue finché la richiesta non porta un token di conferma recente: una persona, o una concessione di autonomia esplicita, deve aver detto sì, da poco, per questa azione.
Trustvice 360curlIl codice legge i segreti da variabili d’ambiente. Tienili nella shell o nel gestore di segreti, mai in un file che finisce in un commit. Le chiamate alle azioni inviano anche X-Workspace-Id.
Chiama l’azione protetta come al solito. Senza token risponde 412 con il codice confirmation_required. Le docs usano privacy.dsr.submit come esempio.
La chiamata a mint restituisce il token in jti, l’azione a cui è legato in audience e la scadenza.
{ "ok": true,
"jti": "cnf_…",
"audience": "privacy.dsr.submit",
"autonomous": false,
"expiresAt": "2026-09-14T13:20:37.675Z" }
Trustvice 360: dia fiducia ai Suoi agenti AI e li governi con evidenza firmata e verificabile.
Digital Trust. On the Record.
La piattaforma di innovazione per
Software‑as‑a‑Service.
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." } }Chiedi a POST /api/v1/confirmations/mint un token per quell’id di azione. Il token è legato all’attore chiamante e al pubblico dell’azione, dura pochi secondi e si consuma al primo 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" }'Invia di nuovo la stessa chiamata con il jti del token in X-Trustvice-Confirmation. Ora l’azione viene eseguita e restituisce il suo risultato reale.
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 che deve chiamare azioni protette senza un clic umano a ogni chiamata ha una concessione di autonomia: a tempo, con un tetto di sicurezza, registrata nel workspace. Concederla richiede un token di conferma umano per il pubblico agents.autonomy.grant. Finché una concessione che la copre è attiva, mint restituisce token autonomous: true per le azioni nel suo ambito.
POST /api/v1/autonomy/grant { "maxSafetyLevel": …, "ttlSeconds": … }
POST /api/v1/autonomy/revoke
GET /api/v1/autonomy/statusCopiato da: /docs/confirmations
Ogni affermazione qui sopra viene dalle docs di Trustvice collegate in questa pagina. Dove una pagina delle docs dice di più, fa testo quella.
Ottieni un token di accesso OAuth, trova un’azione nel catalogo pubblico e chiamala su POST /api/v1/actions/<id>.
Una breve email quando aggiungiamo ricette. Nessun’altra posta, e ti disiscrivi da ogni messaggio.
Un endpoint POST per ogni azione registrata, con lo stesso comportamento via REST e MCP. Le docs elencano ogni azione con input e permessi.