Agentic API のアクションを呼び出す
OAuth アクセストークンを発行し、公開カタログでアクションを探して POST /api/v1/actions/<id> で呼び出します。
4ステップcurlHTTP
OAuth アクセストークンを発行し、公開カタログでアクションを探して POST /api/v1/actions/<id> で呼び出します。
エージェントやスクリプトなどの機械的な呼び出し元から、Trustvice の機能をひとつ使いたい場合です。どの機能も、固定の ID、型付きの入力、共通のレスポンスエンベロープを持つ登録済みアクションなので、ひとつのリクエスト形式ですべてに対応できます。
Trustvice 360
tvc_… の ID とそのシークレット）curlコードはシークレットを環境変数から読み込みます。シェルかシークレットストアに保管し、コミットするファイルには決して書かないでください。アクションの呼び出しでは X-Workspace-Id も送ります。
OAuth クライアントの ID とシークレットを client_credentials でアクセストークンに交換します。トークンの有効期間は 1 時間（expires_in: 3600）で、クライアントの権限スコープを持ちます。TRUSTVICE_TOKEN としてエクスポートしてください。
どのアクションも同じエンベロープで応答します。ok: true と data、または ok: false と error のコードとメッセージです。
{ "ok": true, "data": { …action output… } }
{ "ok": false, "error": { "code": "not_found", : } }401 unauthenticated が返り、中途半端に認証されたリクエストにはなりません。403 permission_denied が返り、必要だった権限が正確に示されます。
curl -sS -X POST https://api.trustvice.com/api/v1/oauth/token \
-H "Content-Type: application/json" \
-d "{\"grant_type\":\"client_credentials\",\"client_id\":\"tvc_…\",\"client_secret\":\"$TRUSTVICE_CLIENT_SECRET\"}"POST /api/v1/oauth/token
{ "grant_type": "client_credentials",
"client_id": "tvc_…", "client_secret": "…" }登録済みアクションの公開カタログは GET /api/v1/actions で、認証なしで取得できます。アクション ID は <domain>.<noun>.<verb> の階層形式です。各アクションの入力スキーマと権限は API リファレンスに載っています。
curl -sS https://api.trustvice.com/api/v1/actionsアクションの入力を JSON で POST /api/v1/actions/<action-id> に送ります。アクセストークンとワークスペース ID を付けてください。ワークスペース API キーはここでは意図的に拒否されます。API キーが与えるのはワークスペースへのアクセスであって、エージェントの意図ではないためです。
curl -sS -X POST https://api.trustvice.com/api/v1/actions/<action-id> \
-H "Authorization: Bearer $TRUSTVICE_TOKEN" \
-H "X-Workspace-Id: ws_…" \
-H "Content-Type: application/json" \
-d '{ … }'POST /api/v1/actions/<action-id>
Authorization: Bearer <oauth-access-token>
X-Workspace-Id: ws_…
Content-Type: application/json
{ …input fields… }まず ok を確認します。成功時の出力は data に、失敗時は error に機械可読な code と人が読める文が入ります。ドメインの 404 や 422 は製品としての回答であり、通信エラーではありません。
転載元の資料: /docs/actions
Idempotency-Key ヘッダーを受け付けるのは、冪等とされたアクションだけです。412 confirmation_required を返します。上記の内容はすべて、このページからリンクしている Trustvice のドキュメントに基づいています。ドキュメントのほうが詳しい場合は、そちらが基準です。
412 confirmation_required に対応します。確認トークンを発行し、X-Trustvice-Confirmation を付けて呼び出しをやり直します。
レシピ集にレシピを追加したときだけ、短いメールを1通。ほかのメールは送らず、どのメールからも配信停止できます。
登録済みアクションごとに POST エンドポイントがひとつあり、REST でも MCP でも同じように動きます。ドキュメントには各アクションの入力と権限が載っています。