Eine destruktive Aktion bestätigen
412 confirmation_required behandeln: ein Bestätigungstoken ausstellen und den Aufruf mit X-Trustvice-Confirmation wiederholen.
412 confirmation_required behandeln: ein Bestätigungstoken ausstellen und den Aufruf mit X-Trustvice-Confirmation wiederholen.
Agenten, Nachweise, Governance, Handel und Offenlegung stecken in Trustvice 360. Kostenlos registrieren und alle Suiten in einem Dashboard öffnen.
Ihr Aufrufer braucht eine Aktion mit confirmationPolicy "always", also jede destructive- und billing_impacting-Aktion. Trustvice führt sie erst aus, wenn die Anfrage ein frisches Bestätigungstoken trägt: Ein Mensch oder eine ausdrückliche Autonomie-Freigabe muss kürzlich für genau diese Aktion zugestimmt haben.
curlDer Code liest Geheimnisse aus Umgebungsvariablen. Halten Sie sie in Shell oder Secret-Store, nie in einer committeten Datei. Aktionsaufrufe senden außerdem X-Workspace-Id.
Rufen Sie die geschützte Aktion wie gewohnt auf. Ohne Token antwortet sie mit 412 und dem Code confirmation_required. Die Docs nutzen privacy.dsr.submit als Beispiel.
Der mint-Aufruf liefert das Token in jti, die gebundene Aktion in audience und den Ablaufzeitpunkt.
{ "ok": true,
"jti": "cnf_…",
"audience": "privacy.dsr.submit",
"autonomous": false,
"expiresAt": "2026-09-14T13:20:37.675Z" }
Trustvice 360: Vertrauen Sie Ihren KI-Agenten und steuern Sie sie mit signierten, überprüfbaren Nachweisen.
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." } }Fordern Sie bei POST /api/v1/confirmations/mint ein Token für diese Aktions-ID an. Das Token ist an den aufrufenden Akteur und die Zielgruppe der Aktion gebunden, lebt Sekunden und wird bei der ersten Nutzung verbraucht.
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" }'Senden Sie denselben Aufruf erneut mit dem jti des Tokens in X-Trustvice-Confirmation. Jetzt läuft die Aktion und liefert ihr echtes Ergebnis.
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 '{ … }'Ein Agent, der geschützte Aktionen ohne menschlichen Klick pro Aufruf ausführen muss, hält eine Autonomie-Freigabe: zeitlich begrenzt, mit Sicherheitsobergrenze, im Workspace erfasst. Eine Freigabe zu erteilen braucht ein menschliches Bestätigungstoken für die Zielgruppe agents.autonomy.grant. Solange eine passende Freigabe aktiv ist, liefert mint Tokens mit autonomous: true für Aktionen in ihrem Umfang.
POST /api/v1/autonomy/grant { "maxSafetyLevel": …, "ttlSeconds": … }
POST /api/v1/autonomy/revoke
GET /api/v1/autonomy/statusKopiert aus: /docs/confirmations
Jede Aussage oben stammt aus den auf dieser Seite verlinkten Trustvice-Docs. Wo eine Docs-Seite mehr sagt, ist sie maßgeblich.
Ein OAuth-Access-Token ausstellen, eine Aktion im öffentlichen Katalog finden und sie unter POST /api/v1/actions/<id> aufrufen.
Eine kurze E-Mail, wenn wir neue Rezepte ergänzen. Sonst keine Mail, und Sie melden sich aus jeder Nachricht ab.
Ein POST-Endpunkt pro registrierter Aktion, mit gleichem Verhalten über REST und MCP. Die Docs listen jede Aktion mit Eingabe und Berechtigungen.