破壊的なアクションを確認する
412 confirmation_required に対応します。確認トークンを発行し、X-Trustvice-Confirmation を付けて呼び出しをやり直します。
4ステップcurlHTTP
412 confirmation_required に対応します。確認トークンを発行し、X-Trustvice-Confirmation を付けて呼び出しをやり直します。
confirmationPolicy が "always" のアクション、つまり destructive と billing_impacting のすべてのアクションを呼び出す必要がある場合です。Trustvice は、リクエストに新しい確認トークンが付くまでこれらを実行しません。人、または明示的な自律権限が、最近このアクションについて承認している必要があります。
Trustvice 360
curlコードはシークレットを環境変数から読み込みます。シェルかシークレットストアに保管し、コミットするファイルには決して書かないでください。アクションの呼び出しでは X-Workspace-Id も送ります。
保護されたアクションを通常どおり呼び出します。トークンがないと、コード confirmation_required とともに 412 が返ります。ドキュメントでは privacy.dsr.submit を例にしています。
mint の呼び出しは、jti にトークンを、audience に結び付いたアクションを、そして有効期限を返します。
{ "ok": true,
"jti": "cnf_…",
"audience": "privacy.dsr.submit",
"autonomous": false,
"expiresAt": "2026-09-14T13:20:37.675Z" }
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." } }POST /api/v1/confirmations/mint に、そのアクション ID 用のトークンを求めます。トークンは呼び出し元のアクターとアクションのオーディエンスに結び付き、数秒で失効し、最初の使用で消費されます。
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" }'トークンの jti を X-Trustvice-Confirmation に入れて、同じ呼び出しをもう一度送ります。今度はアクションが実行され、本来の結果が返ります。
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 '{ … }'呼び出しごとに人がクリックせずに保護されたアクションを実行する必要があるエージェントは、自律権限を持ちます。期限付きで、安全性の上限があり、ワークスペースに記録されます。付与するには、agents.autonomy.grant オーディエンス向けに人が発行した確認トークンが必要です。対象をカバーする権限が有効な間、mint は範囲内のアクションに autonomous: true のトークンを返します。
POST /api/v1/autonomy/grant { "maxSafetyLevel": …, "ttlSeconds": … }
POST /api/v1/autonomy/revoke
GET /api/v1/autonomy/status転載元の資料: /docs/confirmations
上記の内容はすべて、このページからリンクしている Trustvice のドキュメントに基づいています。ドキュメントのほうが詳しい場合は、そちらが基準です。
OAuth アクセストークンを発行し、公開カタログでアクションを探して POST /api/v1/actions/<id> で呼び出します。
レシピ集にレシピを追加したときだけ、短いメールを1通。ほかのメールは送らず、どのメールからも配信停止できます。
登録済みアクションごとに POST エンドポイントがひとつあり、REST でも MCP でも同じように動きます。ドキュメントには各アクションの入力と権限が載っています。