Eine destruktive Aktion bestätigen

412 confirmation_required behandeln: ein Bestätigungstoken ausstellen und den Aufruf mit X-Trustvice-Confirmation wiederholen.

4 SchrittecurlHTTP

Einsatz

Aufgabe

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.

Voraussetzungen

Bevor Sie starten

Konto: Ein Trustvice-Workspace
Zugangsart: Ein OAuth-Access-Token
Außerdem nötig: Ein OAuth-Access-Token, wie im ersten Rezept
curl

Der 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.

Anleitung

Schritte

Die Aktion aufrufen

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.

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." } }

Ein Bestätigungstoken ausstellen
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
```
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" }'
```

Die Aktion wiederholen

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

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 '{ … }'

Einen Agenten in Grenzen handeln lassen
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.
HTTP
```
POST /api/v1/autonomy/grant    { "maxSafetyLevel": …, "ttlSeconds": … }
POST /api/v1/autonomy/revoke
GET  /api/v1/autonomy/status
```

Kopiert aus: /docs/confirmations

Beispielausgabe

Was zurückkommt

Der mint-Aufruf liefert das Token in jti, die gebundene Aktion in audience und den Ablaufzeitpunkt.

JSON

confirmations/mint

{ "ok": true,
  "jti": "cnf_…",
  "audience": "privacy.dsr.submit",
  "autonomous": false,
  "expiresAt": "2026-09-14T13:20:37.675Z" }

Nachweis

Worauf Sie sich verlassen können

Darauf können Sie sich verlassen

Ein Bestätigungstoken lässt sich weder wiederverwenden noch für eine andere Aktion nutzen.
Eine geschützte Aktion läuft nie stillschweigend: Jeder Aufruf braucht ein frisches Token oder eine passende Autonomie-Freigabe.
Autonomie kann nie autonom entstehen.

Nicht annehmen

Dass ein zweiter bestätigter Aufruf harmlos ist: Unsichere Aktionen sind nicht idempotent, ein zweiter Aufruf ist eine zweite Wirkung.
Dass ein Token weiter gilt: Es lebt nur Sekunden.

Jede Aussage oben stammt aus den auf dieser Seite verlinkten Trustvice-Docs. Wo eine Docs-Seite mehr sagt, ist sie maßgeblich.

Weiter geht's

Wie weiter

Dokumentation

Eine Agentic-API-Aktion aufrufen

Ein OAuth-Access-Token ausstellen, eine Aktion im öffentlichen Katalog finden und sie unter POST /api/v1/actions/<id> aufrufen.

4 Schrittecurl · HTTP

MCP-Clients

Einen MCP-Client verbinden

Den Trustvice-MCP-Server unter https://mcp.trustvice.com/mcp in Claude Code, Cursor oder VS Code hinzufügen.

2 SchritteClaude Code · Cursor · VS Code

Einen Beleg prüfen

Einen Beleg im Browser prüfen

Einen signierten Trustvice-Beleg in /verify einfügen und seine Ed25519-Signatur im eigenen Browser prüfen.

3 Schritte

Newsletter

Neue Rezepte

Neue Rezepte per Mail

Eine kurze E-Mail, wenn wir neue Rezepte ergänzen. Sonst keine Mail, und Sie melden sich aus jeder Nachricht ab.

Starten Sie mit der Agentic API.

Ein POST-Endpunkt pro registrierter Aktion, mit gleichem Verhalten über REST und MCP. Die Docs listen jede Aktion mit Eingabe und Berechtigungen.

Docs zu Aktionen lesen API-Referenz öffnen Einen Beleg prüfen →

Eine destruktive Aktion bestätigen

412 confirmation_required behandeln: ein Bestätigungstoken ausstellen und den Aufruf mit X-Trustvice-Confirmation wiederholen.

4 SchrittecurlHTTP

Einsatz

Aufgabe

Voraussetzungen

Bevor Sie starten

Konto: Ein Trustvice-Workspace
Zugangsart: Ein OAuth-Access-Token
Außerdem nötig: Ein OAuth-Access-Token, wie im ersten Rezept
curl

Der 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.

Anleitung

Schritte

Die Aktion aufrufen

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.

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." } }

Ein Bestätigungstoken ausstellen
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
```
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" }'
```

Die Aktion wiederholen

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

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 '{ … }'

Einen Agenten in Grenzen handeln lassen
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.
HTTP
```
POST /api/v1/autonomy/grant    { "maxSafetyLevel": …, "ttlSeconds": … }
POST /api/v1/autonomy/revoke
GET  /api/v1/autonomy/status
```

Kopiert aus: /docs/confirmations

Beispielausgabe

Was zurückkommt

Der mint-Aufruf liefert das Token in jti, die gebundene Aktion in audience und den Ablaufzeitpunkt.

JSON

confirmations/mint

{ "ok": true,
  "jti": "cnf_…",
  "audience": "privacy.dsr.submit",
  "autonomous": false,
  "expiresAt": "2026-09-14T13:20:37.675Z" }

Nachweis

Worauf Sie sich verlassen können

Darauf können Sie sich verlassen

Ein Bestätigungstoken lässt sich weder wiederverwenden noch für eine andere Aktion nutzen.
Eine geschützte Aktion läuft nie stillschweigend: Jeder Aufruf braucht ein frisches Token oder eine passende Autonomie-Freigabe.
Autonomie kann nie autonom entstehen.

Nicht annehmen

Dass ein zweiter bestätigter Aufruf harmlos ist: Unsichere Aktionen sind nicht idempotent, ein zweiter Aufruf ist eine zweite Wirkung.
Dass ein Token weiter gilt: Es lebt nur Sekunden.

Jede Aussage oben stammt aus den auf dieser Seite verlinkten Trustvice-Docs. Wo eine Docs-Seite mehr sagt, ist sie maßgeblich.

Weiter geht's

Wie weiter

Dokumentation

Eine Agentic-API-Aktion aufrufen

Ein OAuth-Access-Token ausstellen, eine Aktion im öffentlichen Katalog finden und sie unter POST /api/v1/actions/<id> aufrufen.

4 Schrittecurl · HTTP

MCP-Clients

Einen MCP-Client verbinden

Den Trustvice-MCP-Server unter https://mcp.trustvice.com/mcp in Claude Code, Cursor oder VS Code hinzufügen.

2 SchritteClaude Code · Cursor · VS Code

Einen Beleg prüfen

Einen Beleg im Browser prüfen

Einen signierten Trustvice-Beleg in /verify einfügen und seine Ed25519-Signatur im eigenen Browser prüfen.

3 Schritte

Newsletter

Neue Rezepte

Neue Rezepte per Mail

Eine kurze E-Mail, wenn wir neue Rezepte ergänzen. Sonst keine Mail, und Sie melden sich aus jeder Nachricht ab.

Starten Sie mit der Agentic API.

Ein POST-Endpunkt pro registrierter Aktion, mit gleichem Verhalten über REST und MCP. Die Docs listen jede Aktion mit Eingabe und Berechtigungen.

Docs zu Aktionen lesen API-Referenz öffnen Einen Beleg prüfen →

Eine destruktive Aktion bestätigen

Aufgabe

Bevor Sie starten

Schritte

Die Aktion aufrufen

Ein Bestätigungstoken ausstellen

Die Aktion wiederholen

Einen Agenten in Grenzen handeln lassen

Was zurückkommt

Worauf Sie sich verlassen können

✓Darauf können Sie sich verlassen

×Nicht annehmen

Wie weiter

Dokumentation

Verwandte Rezepte

Eine Agentic-API-Aktion aufrufen

Einen MCP-Client verbinden

Einen Beleg im Browser prüfen

Neue Rezepte per Mail

Starten Sie mit der Agentic API.

Regeln festlegen. Jeden Lauf prüfen lassen.

Eine destruktive Aktion bestätigen

Aufgabe

Bevor Sie starten

Schritte

Die Aktion aufrufen

Ein Bestätigungstoken ausstellen

Die Aktion wiederholen

Einen Agenten in Grenzen handeln lassen

Was zurückkommt

Worauf Sie sich verlassen können

✓Darauf können Sie sich verlassen

×Nicht annehmen

Wie weiter

Dokumentation

Verwandte Rezepte

Eine Agentic-API-Aktion aufrufen

Einen MCP-Client verbinden

Einen Beleg im Browser prüfen

Neue Rezepte per Mail

Starten Sie mit der Agentic API.

Regeln festlegen. Jeden Lauf prüfen lassen.

Darauf können Sie sich verlassen

Nicht annehmen

Darauf können Sie sich verlassen

Nicht annehmen